Recall

Provides MCP-based access to Recall account, bucket, and object actions, including security-conscious handling of private keys.

javascript

7

GitHub Stars

javascript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "recallnet-recall-mcp": {
      "command": "node",
      "args": [
        "/path/to/recall-mcp/dist/index.js"
      ],
      "env": {
        "DEBUG": "true",
        "RECALL_NETWORK": "testnet",
        "RECALL_PRIVATE_KEY": "YOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

You can run Recall’s MCP server to expose recall operations for account, bucket, and object management to MCP clients like Cursor and Claude Desktop. This server handles sensitive keys securely and provides a programmable interface to interact with Recall services for blockchain storage tasks.

How to use

You interact with the Recall MCP server through a local process or via an MCP-compatible client. Start the server using a standard Node runtime, then configure your client to connect to it as a standard MCP endpoint. The server exposes tools you can call to manage accounts, query balances, buy credit, list and create buckets, and manage objects inside buckets. When you issue commands from your MCP client, the server processes them and returns results through the MCP channel without exposing sensitive credentials.

How to install

Prerequisites: you need Node.js installed on your system. You should also have a private key for Recall operations and a configured environment for secure operation.

Step 1. Install dependencies for the project.

Step 2. Build and start the server.

Additional setup and usage details

Security is a priority. Your private key is loaded during initialization and then removed from environment variables. It is never logged or sent to the MCP client. Use the dedicated security practices to protect the private key and avoid exposing it in logs or shared environments.

Environment variables you will configure include RECALL_PRIVATE_KEY and RECALL_NETWORK. You can enable optional debugging with DEBUG in your local setup.

Configuring the MCP server for your environment

If you are using the standard local setup, you will run the server as a local process. The command is node with the path to the built MCP server entry file.

Available tools

get_account

Retrieve Recall account information such as account identifier and basic metadata.

get_balance

Query the credit balance available in the Recall account.

buy_credit

Purchase additional credit for the Recall account using a specified amount.

list_buckets

List all existing buckets in Recall.

create_bucket

Create a new bucket with a given alias.

list_bucket_objects

List all objects within a specified bucket.

get_object

Retrieve a specific object from a bucket using its bucket identifier and key.

add_object

Add or update an object in a bucket with a given key and data, with an option to overwrite.

security_guidance

Provide security guidance for handling private keys without exposing sensitive data.