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 who work with agent, onchain and mint and want it reachable from 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-09-18 · VERIFIED 2026-09-18

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

Register

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

Latest releases

v1.0.0 · 2026-08-28

!three.ws · three.ws is an Android app. Install it and the platform opens full-screen, with no browser chrome around it, and every signature is routed to the wallet on your phone. · Install · 1. Open…

04 · Who maintains Metaplex Agent Registry

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

  1. three.ws Copy Trading Manage copy-trade follows - follow leaders, tune sizing and guard rules, and track fees owed. ★ 194
  2. Alibaba Cloud DashScope - Qwen Alibaba Cloud DashScope MCP: Qwen chat, embeddings, and model discovery on your own account. ★ 194
  3. pump.fun Solana Data Free, read-only pump.fun + Solana MCP: token discovery, on-chain analysis, SNS, 3D snapshots. ★ 194
  4. three.ws Vanity Read the three.ws vanity-address market: quote difficulty + USDC price, browse the board. ★ 194
  5. three.ws Naming On-chain identity for AI agents: resolve .sol names, reverse-lookup wallets, check handles. ★ 194
  6. $THREE Token Price, hold, and burn $THREE on Solana - the first MCP server whose actions burn a token. ★ 194

05 · Facts

category
AI & ML - actively maintained as of 2026-09-18.
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-09-18, its last commit was 2026-09-18. 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