Base is a tool that provides onchain interactions for AI applications, allowing them to interact with the Base Network and Coinbase API.

What can I do with Base?

You can use Base to retrieve wallet addresses, list balances, transfer funds, deploy smart contracts, interact with Morpho vaults, buy OpenRouter credits, and more, all within AI apps like Claude Desktop.

What kind of AI applications does Base support?

Base is primarily designed for AI applications like Claude Desktop and Cursor. It allows these tools to easily interact with the Base Network and Coinbase API using natural language.

How do I integrate Base with Claude Desktop?

You can integrate Base by adding a configuration to the Claude Desktop configuration file, specifying the command, arguments, and environment variables needed to run the Base MCP server.

What are the prerequisites for using Base?

You'll need Node.js, npm (or yarn), Coinbase API credentials (API Key Name and Private Key), a wallet seed phrase, a Coinbase Project ID (for onramp functionality), and optionally an OpenRouter API key for buying OpenRouter credits.

Características Principales

01Onchain tools integration for AI apps like Claude Desktop and Cursor.

02Interact with the Base Network and Coinbase API.

03Extensible design allows for adding custom tools and data sources.

04Includes tools for wallet management, fund transfers, and smart contract deployment.

05Supports onramping funds via Coinbase and buying OpenRouter credits.

Base MCP Server 🔵

Name: Base
Author: base

A Model Context Protocol (MCP) server that provides onchain tools for AI applications like Claude Desktop and Cursor, allowing them to interact with the Base Network and Coinbase API.

Overview

This MCP server extends any MCP client's capabilities by providing tools to do anything on Base:

Retrieve wallet addresses
List wallet balances
Transfer funds between wallets
Deploy smart contracts
Interact with Morpho vaults for onchain lending
Call contract functions
Onramp funds via Coinbase
Manage ERC20 tokens
Buy OpenRouter credits with USDC

The server interacts with Base, powered by Base Developer Tools and AgentKit.

Extending Base MCP with 3P Protocols, Tools, and Data Sources

Base MCP is designed to be extensible, allowing you to add your own third-party protocols, tools, and data sources. This section provides an overview of how to extend the Base MCP server with new capabilities.

Adding New Tools

If you want to add a new tool to the Base MCP server, follow these steps:

Create a new directory in the src/tools directory for your tool
Implement the tool following the existing patterns:
- index.ts: Define and export your tools
- schemas.ts: Define input schemas for your tools
- handlers.ts: Implement the functionality of your tools
Add your tool to the list of available tools in src/tools/index.ts
Add documentation for your tool in the README.md
Add examples of how to use your tool in examples.md
Write tests for your tool

Project Structure

The Base MCP server follows this structure for tools:

src/
├── tools/
│   ├── index.ts (exports toolsets)
│   ├── [TOOL_NAME]/ <-------------------------- ADD DIR HERE
│   │   ├── index.ts (defines and exports tools)
│   │   ├── schemas.ts (defines input schema)
│   │   └── handlers.ts (implements tool functionality)
│   └── utils/ (shared tool utilities)

Best Practices for Tool Development

When developing new tools for Base MCP:

Follow the existing code style and patterns
Ensure your tool has a clear, focused purpose
Provide comprehensive input validation
Include detailed error handling
Write thorough documentation
Add examples demonstrating how to use your tool
Include tests for your tool

For more detailed information on contributing to Base MCP, including adding new tools and protocols, see the CONTRIBUTING.md file.

Prerequisites

Node.js (v16 or higher)
npm or yarn
Coinbase API credentials (API Key Name and Private Key)
A wallet seed phrase
Coinbase Project ID (for onramp functionality)
Optional: OpenRouter API Key (for buying OpenRouter credits)

Installation

Option 1: Install from npm (Recommended)

# Install globally
npm install -g base-mcp

# Or install locally in your project
npm install base-mcp

Once the package is installed, you can configure clients with the following command:

base-mcp --init

Option 2: Install from Source

Clone this repository:

git clone https://github.com/base/base-mcp.git
cd base-mcp

Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```
Optionally, link it globally:
```
npm link
```

Configuration

Create a .env file with your credentials:

# Coinbase API credentials
# You can obtain these from the Coinbase Developer Portal: https://cdp.coinbase.com/
COINBASE_API_KEY_NAME=your_api_key_name
COINBASE_API_PRIVATE_KEY=your_private_key

# Wallet seed phrase (12 or 24 words)
# This is the mnemonic phrase for your wallet
SEED_PHRASE=your seed phrase here

# Coinbase Project ID (for onramp functionality)
# You can obtain this from the Coinbase Developer Portal
COINBASE_PROJECT_ID=your_project_id

# OpenRouter API Key (optional for buying OpenRouter credits)
# You can obtain this from https://openrouter.ai/keys
OPENROUTER_API_KEY=your_openrouter_api_key

Testing

Test the MCP server to verify it's working correctly:

npm test

This script will verify that your MCP server is working correctly by testing the connection and available tools.

Examples

See the examples.md file for detailed examples of how to interact with the Base MCP tools through Claude.

Integration with Claude Desktop

To add this MCP server to Claude Desktop:

Create or edit the Claude Desktop configuration file at:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json

You can easily access this file via the Claude Desktop app by navigating to Claude > Settings > Developer > Edit Config.

Add the following configuration:

{
  "mcpServers": {
    "base-mcp": {
      "command": "npx",
      "args": ["base-mcp@latest"],
      "env": {
        "COINBASE_API_KEY_NAME": "your_api_key_name",
        "COINBASE_API_PRIVATE_KEY": "your_private_key",
        "SEED_PHRASE": "your seed phrase here",
        "COINBASE_PROJECT_ID": "your_project_id",
        "OPENROUTER_API_KEY": "your_openrouter_api_key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Restart Claude Desktop for the changes to take effect.

Available Tools

get-address

Retrieves the address for your wallet.

Example query to Claude:

"What's my wallet address?"

list-balances

Lists all balances for your wallet.

Example query to Claude:

"Show me my wallet balances."

transfer-funds

Transfers funds from your wallet to another address.

Parameters:

destination: The address to which to transfer funds
assetId: The asset ID to transfer
amount: The amount of funds to transfer

Example query to Claude:

"Transfer 0.01 ETH to 0x1234567890abcdef1234567890abcdef12345678."

deploy-contract

Deploys a smart contract to the blockchain.

Parameters:

constructorArgs: The arguments for the contract constructor
contractName: The name of the contract to deploy
solidityInputJson: The JSON input for the Solidity compiler containing contract source and settings
solidityVersion: The version of the solidity compiler

Example query to Claude:

"Deploy a simple ERC20 token contract for me."

get_morpho_vaults

Gets the vaults for a given asset on Morpho.

Parameters:

assetSymbol: Asset symbol by which to filter vaults (optional)

Example query to Claude:

"Show me the available Morpho vaults for USDC."

call_contract

Calls a contract function on the blockchain.

Parameters:

contractAddress: The address of the contract to call
functionName: The name of the function to call
functionArgs: The arguments to pass to the function
abi: The ABI of the contract
value: The value of ETH to send with the transaction (optional)

Example query to Claude:

"Call the balanceOf function on the contract at 0x1234567890abcdef1234567890abcdef12345678."

get_onramp_assets

Gets the assets available for onramping in a given country/subdivision.

Parameters:

country: ISO 3166-1 two-digit country code string representing the purchasing user's country of residence
subdivision: ISO 3166-2 two-digit country subdivision code (required for US)

Example query to Claude:

"What assets can I onramp in the US, specifically in New York?"

onramp

Gets a URL for onramping funds via Coinbase.

Parameters:

amountUsd: The amount of funds to onramp
assetId: The asset ID to onramp

Example query to Claude:

"I want to onramp $100 worth of ETH."

erc20_balance

Gets the balance of an ERC20 token.

Parameters:

contractAddress: The address of the ERC20 contract

Example query to Claude:

"What's my balance of the token at 0x1234567890abcdef1234567890abcdef12345678?"

erc20_transfer

Transfers an ERC20 token to another address.

Parameters:

contractAddress: The address of the ERC20 contract
toAddress: The address of the recipient
amount: The amount of tokens to transfer

Example query to Claude:

"Transfer 10 USDC to 0x1234567890abcdef1234567890abcdef12345678."

buy_openrouter_credits

Buys OpenRouter credits with USDC.

Parameters:

amountUsd: The amount of credits to buy, in USD

Example query to Claude:

"Buy $20 worth of OpenRouter credits."

Security Considerations

The configuration file contains sensitive information (API keys and seed phrases). Ensure it's properly secured and not shared.
Consider using environment variables or a secure credential manager instead of hardcoding sensitive information.
Be cautious when transferring funds or deploying contracts, as these operations are irreversible on the blockchain.
When using the onramp functionality, ensure you're on a secure connection.
Verify all transaction details before confirming, especially when transferring funds or buying credits.

Troubleshooting

If you encounter issues:

Check that your Coinbase API credentials are correct
Verify that your seed phrase is valid
Ensure you're on the correct network (Base Mainnet)
Check the Claude Desktop logs for any error messages

License

MIT License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

For detailed guidelines on contributing to Base MCP, including:

Reporting bugs
Suggesting enhancements
Development setup
Coding standards
Adding new tools, protocols, and data sources (see also the Extending Base MCP section above)
Testing requirements
Documentation standards

Please refer to our comprehensive CONTRIBUTING.md guide.

Basic contribution steps:

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Please make sure your code follows the existing style and includes appropriate tests.

Características Principales

01Onchain tools integration for AI apps like Claude Desktop and Cursor.

02Interact with the Base Network and Coinbase API.

03Extensible design allows for adding custom tools and data sources.

04Includes tools for wallet management, fund transfers, and smart contract deployment.

05Supports onramping funds via Coinbase and buying OpenRouter credits.

src/ ├── tools/ │ ├── index.ts (exports toolsets) │ ├── [TOOL_NAME]/ <-------------------------- ADD DIR HERE │ │ ├── index.ts (defines and exports tools) │ │ ├── schemas.ts (defines input schema) │ │ └── handlers.ts (implements tool functionality) │ └── utils/ (shared tool utilities)

# Coinbase API credentials # You can obtain these from the Coinbase Developer Portal: https://cdp.coinbase.com/ COINBASE_API_KEY_NAME=your_api_key_name COINBASE_API_PRIVATE_KEY=your_private_key # Wallet seed phrase (12 or 24 words) # This is the mnemonic phrase for your wallet SEED_PHRASE=your seed phrase here # Coinbase Project ID (for onramp functionality) # You can obtain this from the Coinbase Developer Portal COINBASE_PROJECT_ID=your_project_id # OpenRouter API Key (optional for buying OpenRouter credits) # You can obtain this from https://openrouter.ai/keys OPENROUTER_API_KEY=your_openrouter_api_key

{ "mcpServers": { "base-mcp": { "command": "npx", "args": ["base-mcp@latest"], "env": { "COINBASE_API_KEY_NAME": "your_api_key_name", "COINBASE_API_PRIVATE_KEY": "your_private_key", "SEED_PHRASE": "your seed phrase here", "COINBASE_PROJECT_ID": "your_project_id", "OPENROUTER_API_KEY": "your_openrouter_api_key" }, "disabled": false, "autoApprove": [] } } }

Características Principales

Casos de Uso

Base MCP Server 🔵

Overview

Extending Base MCP with 3P Protocols, Tools, and Data Sources

Adding New Tools

Project Structure

Best Practices for Tool Development

Prerequisites

Installation

Option 1: Install from npm (Recommended)

Option 2: Install from Source

Configuration

Testing

Examples

Integration with Claude Desktop

Available Tools

get-address

list-balances

transfer-funds

deploy-contract

get_morpho_vaults

call_contract

get_onramp_assets

onramp

erc20_balance

erc20_transfer

buy_openrouter_credits

Security Considerations

Troubleshooting

License

Contributing

Características Principales

Casos de Uso

Base MCP Server 🔵

Overview

Extending Base MCP with 3P Protocols, Tools, and Data Sources

Adding New Tools

Project Structure

Best Practices for Tool Development

Prerequisites

Installation

Option 1: Install from npm (Recommended)

Option 2: Install from Source

Configuration

Testing

Examples

Integration with Claude Desktop

Available Tools

get-address

list-balances

transfer-funds

deploy-contract

get_morpho_vaults

call_contract

get_onramp_assets

onramp

erc20_balance

erc20_transfer

buy_openrouter_credits

Security Considerations

Troubleshooting

License

Contributing