Skip to content
MCP server

Metaplex Agent Registry

Deploy AI agents on-chain on Solana with an EIP-8004 identity. Deploy fee funds $THREE…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.2.1
Listing updated
5 days ago

About Metaplex Agent Registry

Metaplex Agent Registry is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Deploy AI agents on-chain on Solana with an EIP-8004 identity. Deploy fee funds $THREE buybacks.

Install

Run in a terminal

claude mcp add metaplex-agent --env SOLANA_SECRET_KEY='<SOLANA_SECRET_KEY>' -- npx -y @three-ws/metaplex-agent-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "metaplex-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/metaplex-agent-mcp"
      ],
      "env": {
        "SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "metaplex-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/metaplex-agent-mcp"
      ],
      "env": {
        "SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "metaplex-agent": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/metaplex-agent-mcp"
      ],
      "env": {
        "SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "metaplex-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/metaplex-agent-mcp"
      ],
      "env": {
        "SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "metaplex-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/metaplex-agent-mcp"
      ],
      "env": {
        "SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
      }
    }
  }
}

Configuration

  • SOLANA_SECRET_KEYBase58 secret key (or JSON byte array) for the minting wallet. Optional: read tools and the Phantom/Solflare prepare/send flow work without it.
  • SOLANA_RPC_URLHTTPS Solana RPC endpoint. Defaults to the public endpoint for the configured network; bring your own (Helius / Quicknode / Triton) for production.
  • METAPLEX_AGENT_NETWORKDefault cluster: mainnet or devnet. Defaults to mainnet; every tool also takes a per-call network.
  • REQUIRE_CONFIRMRefuse to broadcast a mint or registration until the call is re-issued with confirm=true. Default true.
  • DEPLOY_FEE_SOLMainnet deploy fee, in SOL, paid to DEPLOY_FEE_WALLET in the same transaction as the mint. Default 0.02.
  • DEPLOY_FEE_WALLETWallet the deploy fee is paid to. Defaults to the three.ws $THREE buyback wallet; override only when self-hosting a fork.
  • DEPLOY_FEE_ENABLEDSet false to build a fork that charges no deploy fee. Default true.
  • THREE_HALF_PRICE_AT$THREE balance in the paying wallet that halves the deploy fee. Default 50000.
  • THREE_FREE_AT$THREE balance in the paying wallet that waives the deploy fee entirely. Default 250000.

Pricing

Open source

Prices change. Check three.ws before you buy.

Metaplex Agent Registry FAQ

Is Metaplex Agent Registry free?

Yes. Metaplex Agent Registry is open source, so you can use and self-host it for free.

How do I add Metaplex Agent Registry to Claude Code?

Run this command in your terminal: claude mcp add metaplex-agent --env SOLANA_SECRET_KEY='<SOLANA_SECRET_KEY>' -- npx -y @three-ws/metaplex-agent-mcp