Metaplex Agent Registry MCP Server

Deploy AI agents on-chain into the Metaplex Agent Registry on Solana, from any MCP client. Its 9 documented tools cover agent, onchain, mint.

People connecting AI & ML tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 37 MCP servers published from nirholas/three.ws. Stars and repository activity are shared across all of them. See all 37 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-24 · VERIFIED 2026-08-25

Apache-2.0 · JavaScript servers · how we verify → /methodology

01 · Install Metaplex Agent Registry

before you install - you'll need

SOLANA_SECRET_KEY is optional or environment-specific per the README.

Claude Code

claude mcp add nirholas-three.ws-packages-metaplex-agen -- npx -y @three-ws/metaplex-agent-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "nirholas-three.ws-packages-metaplex-agen": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/metaplex-agent-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

npm package @three-ws/metaplex-agent-mcp - the @three-ws scope differs from the repo owner (nirholas); confirm it's the project's official package

registry namespace io.github.nirholas is GitHub-verified and matches the repo owner

03 · What Metaplex Agent Registry can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 9 documented tools spanning agent, onchain, mint, including mint_onchain_agent, prepare_agent_mint, send_signed_transaction, register_agent_identity.

Capability map

Tools grouped from the project's README - what Metaplex Agent Registry lets an agent do.

read & search

2 tools - e.g. Read any registered agent: asset, plugins, decoded metadata + registration documents, identity PDA, built-in wallet + balance.; Latest registrations from the live three.ws /api/deployments feed (Solana by…

get_onchain_agent · list_onchain_agents

Mint

1 tool - e.g. Mint + register, signed by your key (atomic when it fits, auto-split otherwise). confirm:true gates the spend; anything else returns a full preview.

mint_onchain_agent

Prepare

1 tool - e.g. The same mint, built for an external wallet (wallet param) to sign. Returns txs_base64, already co-signed by the new asset keypair; sign with signTransaction /

prepare_agent_mint

run & execute

1 tool - e.g. Broadcast wallet-signed transactions in order, polling each to confirmation and absorbing the create/register propagation race.

send_signed_transaction

1 tool - e.g. Enrol an already-minted Core asset in the Agent Registry (idempotent; the signer must be the asset authority).

register_agent_identity

Agent

1 tool - e.g. An asset's built-in wallet (mpl-core Asset Signer PDA), any address, or the configured signer, with live SOL balance.

agent_wallet

Build

1 tool - e.g. The EIP-8004 registration JSON + data: URI, fully offline.

build_registration

Three

1 tool - e.g. Prices your next deploy: fee schedule, a wallet's live $THREE balance and tier, and the public buyback ledger.

three_status

04 · Who maintains Metaplex Agent Registry

Metaplex Agent Registry is maintained by nirholas. We track 66 MCP servers from nirholas - 65 actively maintained, 7,658 combined GitHub stars, oldest repo from Feb 2024. Full record: all servers from nirholas.

05 · Facts

repository: github.com/nirholas/three.ws
website: https://three.ws/
category: AI & ML - actively maintained as of 2026-08-25.
registry: io.github.nirholas/metaplex-agent (active, first published 2026-08-19 · 4 versions)
packages: npm:@three-ws/metaplex-agent-mcp

06 · Metaplex Agent Registry FAQ

Is Metaplex Agent Registry still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-24. We re-verify nightly.

What can Metaplex Agent Registry do?

An agent gets 9 documented tools spanning agent, onchain, mint, including mint_onchain_agent, prepare_agent_mint, send_signed_transaction, register_agent_identity.

How do I install Metaplex Agent Registry?

Run `npx -y @three-ws/metaplex-agent-mcp`. The README documents one environment variable (SOLANA_SECRET_KEY) to set first. SOLANA_SECRET_KEY is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Metaplex Agent Registry run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Metaplex Agent Registry

Alternatives to Metaplex Agent Registry

Maintained AI & ML servers if Metaplex Agent Registry isn't the fit.

Pairs well with

Servers that cover what Metaplex Agent Registry doesn't - only shown when the pairing reason fits the companion.

More AI & ML MCP servers · three.ws Naming · three.ws Notifications · three.ws Portfolio · three.ws Provenance · pump.fun Solana Data