Recall MCP Server

What is Recall MCP Server?

Recall MCP Server is a Model Context Protocol implementation that enables Cursor, Claude Desktop, and other MCP-compatible clients to interact with Recall services for blockchain storage operations. It provides tools for account, bucket, and object management on the Recall network.

How to use Recall MCP Server?

Clone the repository, install dependencies (npm install), build (npm run build), and run (npm run start). Configure either by providing RECALL_PRIVATE_KEY and RECALL_NETWORK environment variables in your client configuration (recommended) or by using a .env file as a fallback. Add the server to Cursor via Settings > MCP Servers or to Claude Desktop by editing its claude_desktop_config.json.

Key features of Recall MCP Server

• Account operations: get info, check balance, buy credit
• Bucket operations: list all buckets, create new buckets
• Object operations: get, add, and list objects in buckets
• Multi‑layer private key protection and automatic log redaction
• Security response tool to intercept sensitive queries
• Environment variable precedence: client config > .env > defaults

Use cases of Recall MCP Server

• Interact with Recall blockchain storage from AI assistants
• Manage buckets and objects programmatically via natural language
• Securely perform blockchain account operations without exposing keys
• Automate credit purchases and balance checks on testnet or mainnet

FAQ from Recall MCP Server

How does Recall MCP Server protect my private key?

The private key is loaded only during initialization, then immediately removed from environment variables. It is never logged, transmitted to the LLM, or exposed. Logs automatically redact key‑like patterns, and a dedicated tool prevents accidental leakage.

What configuration methods are supported?

Two methods: (1) provide environment variables directly in Cursor/Claude Desktop config (recommended), or (2) create a .env file with RECALL_PRIVATE_KEY and optionally RECALL_NETWORK. The server checks client‑provided variables first, then falls back to .env if needed.

Which networks does Recall MCP Server support?

You can set the RECALL_NETWORK environment variable to testnet (default) or mainnet.

Why should I use console.error() instead of console.log() during development?

Claude Desktop communicates via stdout; console.log() interferes with that and causes JSON parsing errors. Use console.error() for all debugging and logging.

What tools does Recall MCP Server expose?

It exposes nine tools: get_account, get_balance, buy_credit, list_buckets, create_bucket, list_bucket_objects, get_object, add_object, and security_guidance. Details and parameters are listed in the README.