Recall MCP Server

Official MCP server for interacting with the Recall network.

Table of Contents

• Table of Contents
• Background
• Usage
  • Configure for Cursor or Claude Desktop
    • Adding to Cursor
    • Adding to Claude Desktop
  • Available tools
• Development
• Contributing
• License

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:

1. In Cursor, go to Settings > Cursor Settings > MCP.
2. 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).
3. 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"
      }
    }
  }
}

4. 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:

1. 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

2. 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"
         }
       }
     }
   }

3. 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) |

Contributing

PRs accepted.

Small note: If editing the README, please conform to the standard-readme specification.

License

MIT OR Apache-2.0, © 2025 Recall Network Corporation