@recallnet/mcp NPM

Recall MCP Server

Official MCP server for interacting with the Recall network.

Background

The @recallnet/mcp server allows agents to interact with the Recall network using the Model Context Protocol (MCP). See the Recall MCP documentation for more information.

Usage

Run the package with npx. You'll need to provide a Recall private key and optionally a network (e.g., testnet or localnet).

npx @recallnet/mcp --private-key=0x... --network=testnet

Or, set the RECALL_PRIVATE_KEY and RECALL_NETWORK environment variables:

RECALL_PRIVATE_KEY=0x... RECALL_NETWORK=testnet npx @recallnet/mcp

Optionally, you can specify the tools you want to enable. By default, all tools are enabled.

npx @recallnet/mcp --private-key=0x... --network=testnet --tools=bucket.read,bucket.write

Configure for Cursor or Claude Desktop

Adding to Cursor

To add this MCP server to Cursor:

In Cursor, go to Settings > Cursor Settings > MCP.
Click "Add New Global MCP Server" to open the server JSON configuration in the editor (i.e., the ~/.cursor/mcp.json file in your home directory).
Add the following configuration:

{
  "mcpServers": {
    "recall-mcp": {
      "name": "Recall MCP",
      "type": "command",
      "command": "npx",
      "args": ["-y", "@recallnet/mcp"],
      "env": {
        "RECALL_PRIVATE_KEY": "0xyour_private_key",
        "RECALL_NETWORK": "testnet",
        "RECALL_TOOLS": "all"
      }
    }
  }
}

Save the configuration file and, if needed, refresh the MCP server in Settings > Cursor Settings > MCP (it's in the top right corner of each MCP server).

Adding to Claude Desktop

To add this MCP server to Claude Desktop:

Locate your Claude Desktop configuration file at:
- On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- On Windows: %APPDATA%\Claude\claude_desktop_config.json
- On Linux: ~/.config/Claude/claude_desktop_config.json

Create or edit the claude_desktop_config.json file with the following content:

{
  "mcpServers": {
    "recall-mcp-server": {
      "name": "Recall MCP",
      "type": "command",
      "command": "npx",
      "args": ["-y", "@recallnet/mcp"],
      "env": {
        "RECALL_PRIVATE_KEY": "0xyour_private_key",
        "RECALL_NETWORK": "testnet",
        "RECALL_TOOLS": "all"
      }
    }
  }
}

Save the configuration file and restart Claude Desktop.

If you encounter issues with Claude Desktop, check the logs at:

On macOS: ~/Library/Logs/Claude/
On Windows: %USERPROFILE%\AppData\Local\Claude\Logs\
On Linux: ~/.local/share/Claude/logs/

Available tools

The server exposes the following MCP tools:

Tool name	Tool scope	Description
`get_account_info`	`account.read`	Get Recall account information (e.g., address, balance)
`get_credit_info`	`account.read`	Get Recall account credit information (e.g., credit available or used)
`buy_credit`	`account.write`	Buy credit for Recall account
`list_buckets`	`bucket.read`	List all buckets owned by an address
`create_bucket`	`bucket.write`	Create a bucket in Recall
`get_or_create_bucket`	`bucket.write`	Get or create a bucket in Recall (using alias)
`add_object`	`bucket.write`	Add an object to a Recall bucket (as a string)
`get_object`	`bucket.read`	Get an object from a Recall bucket (as a string)
`query_objects`	`bucket.read`	Query objects in a Recall bucket

Development

Clone the repository:

git clone https://github.com/recallnet/js-recall.git

And change into the packages/mcp directory:

cd js-recall/packages/mcp

Install dependencies and build the binary:

pnpm install
pnpm build

Run the server directly from the dist directory:

node dist/index.js --private-key=0x... --network=testnet

The following pnpm commands are available:

Command	Description
`pnpm build`	Build the binary
`pnpm dev`	Run in development mode
`pnpm lint`	Lint the project with ESLint
`pnpm lint:fix`	Lint the project and fix linting errors
`pnpm format:check`	Check if the project is formatted with Prettier
`pnpm format`	Format the project (writes files)