Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Metaplex Agent Registry

NPM · @THREE-WS/METAPLEX-AGENT-MCP · SCANNED AUG 20

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

64 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security99
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • 35 of 130 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency35
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
  • License check failed: the license (SEE LICENSE IN LICENSE) isn't a recognized OSI-approved license. See how to fix → Fail
  • Actively maintained (last published 0 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability63
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 3343 tokens (~371/item across 9 items; 9 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
  • Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @three-ws/metaplex-agent-mcp

# add to Claude Code
claude mcp add nirholas-metaplex-agent -- npx -y @three-ws/metaplex-agent-mcp
# add to Codex CLI
codex mcp add nirholas-metaplex-agent -- npx -y @three-ws/metaplex-agent-mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "nirholas-metaplex-agent": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@three-ws/metaplex-agent-mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add nirholas-metaplex-agent --command npx --arg -y --arg @three-ws/metaplex-agent-mcp
# ~/.hermes/config.yaml
mcp_servers:
  nirholas-metaplex-agent:
    command: "npx"
    args: ["-y", "@three-ws/metaplex-agent-mcp"]
// mcp.json
{
  "mcpServers": {
    "nirholas-metaplex-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/metaplex-agent-mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 19 Aug 26 64

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 20 Aug 2026 · Analysed npm/@three-ws/metaplex-agent-mcp@0.2.0

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem npm
Dependencies 130 packages
Packages resolved 130
Stale 35
Tree resolution Complete
MCP tools · 9 exposed · ~3,133 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
agent_wallet ~166

Show a wallet address and its live SOL balance. Pass `asset` to derive an on-chain agent's built-in wallet (the Metaplex Core Asset Signer PDA, the wallet shown on metaplex.com/agents). Pass `address` to inspect any wallet. Pass neither to see the configured signing wallet, e.g. to confirm it is funded before mint_onchain_agent. On mainnet it also reports the wallet $THREE balance and the deploy-fee tier that balance earns (see three_status). Read-only; never moves funds.

NameTypeReqDescription
addressstringA wallet address to inspect verbatim.
assetstringA Core asset address: derives that agent's built-in wallet.
networkstringCluster. Defaults to the configured network.

No output schema declared.

No examples provided.

build_registration ~251

Build the Genesis-style EIP-8004 registration-v1 JSON document and its self-contained data:application/json;base64 URI, without touching Solana. Use it to preview exactly what mint_onchain_agent / register_agent_identity will write on-chain, or to host the document yourself and pass it back as registration_uri.

NameTypeReqDescription
activebooleanRegistration active flag. Default true.
assetstringAsset address for the default chain-registry entry when no registrations are given.
descriptionstringAgent description.
imagestringThumbnail image URL.
model_urlstring3D model URL (GLB), written as model.uri.
namestringyesAgent name.
networkstringNetwork for the default chain-registry entry. Defaults to the configured network.
registrationsarrayExternal registry entries.
servicesarrayServices the agent offers.
supported_trustarrayDefault ['reputation'].
threews_agent_idstringthree.ws agent UUID for the Genesis-exact three.ws entry.
x402_supportbooleanAdvertise x402 payment support. Default false.

No output schema declared.

No examples provided.

get_onchain_agent ~128

Fetch a Metaplex Agent Registry agent by its Core asset address: name, owner, update authority, plugins (royalties, verified creators, immutable metadata, attributes), the decoded asset metadata and EIP-8004 registration documents, whether the identity PDA exists, and the built-in agent wallet (Asset Signer PDA) with its live SOL balance. Read-only. Works on any registered agent, e.g. the three.ws Genesis mints.

NameTypeReqDescription
assetstringyesThe Core asset address (base58).
networkstringCluster. Defaults to the configured network.

No output schema declared.

No examples provided.

list_onchain_agents ~169

The latest agents to land on-chain in the Metaplex Agent Registry, newest first, from the live three.ws /api/deployments feed (which also indexes registrations minted outside three.ws). Each entry carries the Core asset address, name, description, image, owner, 3D and x402 flags, and explorer links. Set all_chains:true to include EVM ERC-8004 registrations in the same stream. Read-only.

NameTypeReqDescription
all_chainsbooleanInclude EVM ERC-8004 registrations too. Default false (Solana only).
cursorstringPagination cursor from a previous call.
limitintegerHow many registrations to return. Default 12.
networkstringSolana cluster. Defaults to the configured network.

No output schema declared.

No examples provided.

mint_onchain_agent ~898

Deploy an AI agent on-chain, Genesis-333 style: mints a Metaplex Core asset (data: URI metadata, verified creator, royalties, immutable metadata) AND registers its EIP-8004 Agent Identity, so it appears on metaplex.com/agents with its own built-in wallet. Runs as ONE atomic transaction when it fits Solana's 1232-byte limit, otherwise as create followed by register (how the Genesis 333 landed). Signs with the configured SOLANA_SECRET_KEY (or a per-call secret) and spends ~0.007 SOL in rent + fees, plus a flat SOL deploy fee on mainnet that funds $THREE buybacks (holding $THREE halves it, then waives it; devnet is free; see three_status). The fee rides in the same transaction as the mint, so a failed mint pays nothing. Without confirm:true it returns a full preview (both JSON documents, the paying wallet, every cost line including the fee and its recipient) and broadcasts NOTHING. For Phantom/Solflare users, use prepare_agent_mint.

NameTypeReqDescription
activebooleanRegistration active flag. Default true.
add_blockerbooleanAttach AddBlocker so no further plugins can be added. Default false.
attributesarrayOn-chain Attributes plugin entries (real bytes in the asset account).
collectionMint into this Metaplex Core collection. The signer must be the collection authority.
confirmbooleanMust be true to broadcast. Anything else returns a spend-nothing preview.
descriptionstringWhat this agent is or does. Stored in the EIP-8004 registration document.
external_urlstringOptional external_url in the asset metadata (e.g. the agent home page).
imagestringThumbnail/avatar image URL (PNG or similar). Shown on metaplex.com/agents, wallets, and explorers.
immutable_metadatabooleanAttach the ImmutableMetadata plugin so the metadata can never change. Default true (Genesis style).
metadata_attributesarrayOff-chain attributes array inside the asset metadata JSON (trait_type/value pairs).
metadata_uristringFull override for the asset metadata URI (https or data:). Skips the built-in metadata builder.
model_urlstring3D model URL (GLB). Written as the asset metadata animation_url and as model.uri in the registration, Genesis style.
namestringyesAgent name. Becomes the Core asset name and the registration name.
networkstringSolana cluster. Defaults to the configured network (mainnet unless overridden).
ownerstringMint the asset to this owner instead of the signing wallet.
permanent_burnbooleanAttach PermanentBurnDelegate. Default false.
permanent_freezebooleanAttach PermanentFreezeDelegate (unfrozen). Default false.
permanent_transferbooleanAttach PermanentTransferDelegate. Default false.
registration_uristringFull override for the Agent Identity registration URI (https or data:). Skips the built-in registration builder.
registrationsarrayExternal registry registrations. Defaults to the chain registry entry, or the three.ws entry when threews_agent_id is set.
royalty_basis_pointsintegerRoyalty in basis points. Default 500 (5%), the Genesis value. 0 removes the Royalties plugin.
royalty_creatorsarrayRoyalty split. Percentages must sum to 100. Defaults to the signing wallet at 100%.
secretstringPer-call signing key (base58 secret key or JSON byte array). Overrides SOLANA_SECRET_KEY.
servicesarrayServices the agent offers, listed on its Metaplex agent page ({name, endpoint}).
supported_trustarrayTrust models the agent supports. Default ['reputation'] (Genesis style).
threews_agent_idstringthree.ws agent UUID. Adds the Genesis-exact registration entry {agentId, agentRegistry: "https://three.ws"}.
verified_creatorbooleanAttach the VerifiedCreators plugin with the signing wallet verified. Default true (Genesis style).
x402_supportbooleanAdvertise x402 payment support in the registration document. Default false.

No output schema declared.

No examples provided.

prepare_agent_mint ~836

Build the exact Genesis-style mint+register flow (Metaplex Core asset + Agent Identity) for an EXTERNAL Solana wallet: Phantom, Solflare, Backpack, Ledger, anything. Needs no secret key. Returns unsigned transactions base64 in txs_base64 (already co-signed by the new asset keypair) with `wallet` as the fee payer: one atomic tx when it fits Solana's size limit, else create + register to sign together via signAllTransactions. The wallet signs and broadcasts, or hands the signed array to send_signed_transaction. Includes the same mainnet deploy fee as mint_onchain_agent, priced against the wallet's live $THREE balance and returned as deploy_fee_sol/deploy_fee_to before anything is signed. Broadcasts nothing itself. The blockhash expires after roughly a minute, so sign promptly and re-prepare if a wallet reports an expired transaction.

NameTypeReqDescription
activebooleanRegistration active flag. Default true.
add_blockerbooleanAttach AddBlocker so no further plugins can be added. Default false.
attributesarrayOn-chain Attributes plugin entries (real bytes in the asset account).
collectionMint into this Metaplex Core collection. The signer must be the collection authority.
descriptionstringWhat this agent is or does. Stored in the EIP-8004 registration document.
external_urlstringOptional external_url in the asset metadata (e.g. the agent home page).
imagestringThumbnail/avatar image URL (PNG or similar). Shown on metaplex.com/agents, wallets, and explorers.
immutable_metadatabooleanAttach the ImmutableMetadata plugin so the metadata can never change. Default true (Genesis style).
metadata_attributesarrayOff-chain attributes array inside the asset metadata JSON (trait_type/value pairs).
metadata_uristringFull override for the asset metadata URI (https or data:). Skips the built-in metadata builder.
model_urlstring3D model URL (GLB). Written as the asset metadata animation_url and as model.uri in the registration, Genesis style.
namestringyesAgent name. Becomes the Core asset name and the registration name.
networkstringSolana cluster. Defaults to the configured network (mainnet unless overridden).
ownerstringMint the asset to this owner instead of the signing wallet.
permanent_burnbooleanAttach PermanentBurnDelegate. Default false.
permanent_freezebooleanAttach PermanentFreezeDelegate (unfrozen). Default false.
permanent_transferbooleanAttach PermanentTransferDelegate. Default false.
registration_uristringFull override for the Agent Identity registration URI (https or data:). Skips the built-in registration builder.
registrationsarrayExternal registry registrations. Defaults to the chain registry entry, or the three.ws entry when threews_agent_id is set.
royalty_basis_pointsintegerRoyalty in basis points. Default 500 (5%), the Genesis value. 0 removes the Royalties plugin.
royalty_creatorsarrayRoyalty split. Percentages must sum to 100. Defaults to the signing wallet at 100%.
servicesarrayServices the agent offers, listed on its Metaplex agent page ({name, endpoint}).
supported_trustarrayTrust models the agent supports. Default ['reputation'] (Genesis style).
threews_agent_idstringthree.ws agent UUID. Adds the Genesis-exact registration entry {agentId, agentRegistry: "https://three.ws"}.
verified_creatorbooleanAttach the VerifiedCreators plugin with the signing wallet verified. Default true (Genesis style).
walletstringyesThe base58 address of the wallet that will sign, pay, and own the agent.
x402_supportbooleanAdvertise x402 payment support in the registration document. Default false.

No output schema declared.

No examples provided.

register_agent_identity ~382

Give an ALREADY-MINTED Metaplex Core asset its Agent Identity: writes the EIP-8004 registration document (as a self-contained data: URI) onto the asset and creates its identity PDA, after which it appears on metaplex.com/agents. The signing wallet must be the asset authority (or the collection authority for collection-bound assets). Registration is one-time per asset and costs ~0.003 SOL; an already-registered asset returns already_registered without spending. Without confirm:true it returns a spend-nothing preview. To mint a NEW agent, use mint_onchain_agent or prepare_agent_mint instead.

NameTypeReqDescription
activebooleanRegistration active flag. Default true.
assetstringyesThe Core asset address to register.
collectionstringThe collection address, required for collection-bound assets.
confirmbooleanMust be true to broadcast. Anything else returns a preview.
descriptionstringAgent description.
imagestringThumbnail image URL.
model_urlstring3D model URL (GLB), written as model.uri.
namestringyesAgent name for the registration document.
networkstringCluster. Defaults to the configured network.
registration_uristringFull override for the registration URI (https or data:).
registrationsarrayExternal registry entries. Defaults to the chain registry entry.
secretstringPer-call signing key. Overrides SOLANA_SECRET_KEY.
servicesarrayServices the agent offers.
supported_trustarrayDefault ['reputation'].
threews_agent_idstringthree.ws agent UUID for the Genesis-exact three.ws registration entry.
x402_supportbooleanAdvertise x402 payment support. Default false.

No output schema declared.

No examples provided.

send_signed_transaction ~146

Broadcast one or more fully signed Solana transactions (base64) IN ORDER, polling each to confirmation before the next. Use it to complete the prepare_agent_mint flow: pass the wallet-signed txs_base64 array and the create/register sequencing (including the propagation race) is handled. Whatever the transactions do on-chain happens for real, so only send bytes you built and inspected.

NameTypeReqDescription
networkstringCluster to broadcast on. Defaults to the configured network.
tx_base64stringA single fully signed transaction, base64 encoded.
txs_base64arrayFully signed transactions to broadcast in order (e.g. create then register).

No output schema declared.

No examples provided.

three_status ~157

What the next on-chain deploy costs and why. Returns the deploy-fee schedule (a flat SOL fee on mainnet, free on devnet), the live $THREE balance of a wallet and the tier it earns (half price, then free), the wallet the fee is paid to, and the live $THREE market + buyback figures from the public three.ws ledger. Pass `wallet` to price a specific payer, or omit it to price the configured signer. Read-only: it moves nothing and needs no key.

NameTypeReqDescription
networkstringCluster. Defaults to the configured network. Devnet deploys are always free.
walletstringPrice the deploy fee for this wallet. Defaults to the configured signer.

No output schema declared.

No examples provided.