Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

MCP Server

Install

Claude Code

claude mcp add functor -- bunx @functornetwork/mcp

That's it. Restart Claude Code; tools and slash commands become available.

To remove:

claude mcp remove functor

Network

The server operates on one chain, selected at startup via the FUNCTOR_CHAIN environment variable. It defaults to BNB Smart Chain Testnet.

FUNCTOR_CHAINChain
bnb-testnet (default)BNB Smart Chain Testnet (97)
sepoliaEthereum Sepolia (11155111)
# Operate on Sepolia instead of the BNB default
claude mcp add functor -e FUNCTOR_CHAIN=sepolia -- bunx @functornetwork/mcp

One server process serves one chain. Restart with a different FUNCTOR_CHAIN to switch.

Cursor / Continue / other hosts

Add this to your host's MCP server config:

{
  "mcpServers": {
    "functor": {
      "command": "bunx",
      "args": ["@functornetwork/mcp"]
    }
  }
}

Keys

Wallet admin keys and session keys live in separate namespaces so they can never collide. The server reads each kind from three places, in order.

Wallet admin keys:
  1. OS keychain under service functor-wallet. Primary. Written by create_wallet.
  2. ~/.functor/keys.json → wallets[]. File fallback. Mode 0600.
  3. FUNCTOR_WALLET_<NAME>_PRIVATE_KEY env var. Env fallback.

For the default wallet, the convention is FUNCTOR_WALLET_DEFAULT_PRIVATE_KEY.

Session keys:
  1. OS keychain under service functor-session. Primary. Written by grant_session.
  2. ~/.functor/keys.json → sessions[]. File fallback.
  3. FUNCTOR_SESSION_<NAME>_PRIVATE_KEY env var.

Functor never sees these keys. They stay on your machine.