Base Blockchain Tools MCP Server

Finance & FintechTypeScript

Interact with Base network and Coinbase API from your AI assistant

Available Tools

get_crypto_price

Get the current price of a cryptocurrency in a specified currency

get_wallet_balance

Get the token balance for a specific wallet address

get_transaction_history

Retrieve transaction history for a wallet address

resolve_farcaster_username

Resolve a Farcaster username to an Ethereum address

get_token_metadata

Get metadata for a specific token on the Base network

get_gas_price

Get the current gas price on the Base network

Base Blockchain Tools provides a comprehensive suite of onchain tools that allow AI assistants to interact with the Base network and Coinbase API. This MCP server enables LLMs to perform blockchain operations, query cryptocurrency data, resolve Farcaster usernames to Ethereum addresses, and execute various other blockchain-related tasks directly through natural language requests.

Base Blockchain Tools

Base Blockchain Tools is a Model Context Protocol (MCP) server that enables AI assistants to interact with the Base network and Coinbase API, providing powerful blockchain capabilities through natural language.

Installation

To install and use the Base Blockchain Tools MCP server, follow these steps:

Install the package from npm:

npm install base-mcp

Configure your environment variables by creating a .env file with the necessary API keys:

COINBASE_API_KEY=your_coinbase_api_key
COINBASE_API_SECRET=your_coinbase_api_secret
ALCHEMY_API_KEY=your_alchemy_api_key
NEYNAR_API_KEY=your_neynar_api_key

Start the MCP server:

npx base-mcp

Add the MCP server configuration to your AI assistant client:

"mcpServers": {
  "base-mcp": {
    "command": "npx",
    "args": ["base-mcp"]
  }
}

Configuration

The Base MCP server requires several API keys to function properly:

Coinbase API: For accessing cryptocurrency price data and account information
Alchemy API: For interacting with the Base network and other Ethereum-compatible blockchains
Neynar API: For resolving Farcaster usernames to Ethereum addresses

You can obtain these API keys by:

Creating a Coinbase account and generating API credentials in the developer settings
Signing up for an Alchemy account and creating an API key
Registering for a Neynar developer account to get an API key

Usage

Once configured, your AI assistant can use the Base MCP tools to perform various blockchain operations through natural language requests. For example:

"What's the current price of Ethereum?"
"Show me the latest transactions on this Base wallet address"
"Resolve the Farcaster username 'vitalik' to an Ethereum address"
"Get the token balance for this wallet"

The MCP server handles the technical details of interacting with the blockchain, allowing for seamless integration of crypto functionality into your AI assistant conversations.

Extending Base MCP

Developers can extend Base MCP with new tools by:

Creating a new tool directory in src/tools/
Implementing the tool functionality following the Base MCP architecture
Exporting the tool in the main index file
Contributing back to the project through a pull request

For detailed development guidelines, refer to the CONTRIBUTING.md file in the repository.