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.
Available components
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.
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
claude mcp add nirholas-metaplex-agent -- npx -y @three-ws/metaplex-agent-mcp
codex mcp add nirholas-metaplex-agent -- npx -y @three-ws/metaplex-agent-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"nirholas-metaplex-agent": {
"type": "local",
"command": [
"npx",
"-y",
"@three-ws/metaplex-agent-mcp"
],
"enabled": true
}
}
} openclaw mcp add nirholas-metaplex-agent --command npx --arg -y --arg @three-ws/metaplex-agent-mcp
mcp_servers:
nirholas-metaplex-agent:
command: "npx"
args: ["-y", "@three-ws/metaplex-agent-mcp"] {
"mcpServers": {
"nirholas-metaplex-agent": {
"command": "npx",
"args": [
"-y",
"@three-ws/metaplex-agent-mcp"
]
}
}
} 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.
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 |
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.
agent_wallet An agent's built-in wallet, or the signer wallet, with balance ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | – | A wallet address to inspect verbatim. |
| asset | string | – | A Core asset address: derives that agent's built-in wallet. |
| network | string | – | Cluster. Defaults to the configured network. |
No output schema declared.
No examples provided.
build_registration Build an EIP-8004 registration document (no chain access) ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| active | boolean | – | Registration active flag. Default true. |
| asset | string | – | Asset address for the default chain-registry entry when no registrations are given. |
| description | string | – | Agent description. |
| image | string | – | Thumbnail image URL. |
| model_url | string | – | 3D model URL (GLB), written as model.uri. |
| name | string | yes | Agent name. |
| network | string | – | Network for the default chain-registry entry. Defaults to the configured network. |
| registrations | array | – | External registry entries. |
| services | array | – | Services the agent offers. |
| supported_trust | array | – | Default ['reputation']. |
| threews_agent_id | string | – | three.ws agent UUID for the Genesis-exact three.ws entry. |
| x402_support | boolean | – | Advertise x402 payment support. Default false. |
No output schema declared.
No examples provided.
get_onchain_agent Read an on-chain agent (asset, registration, wallet) ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| asset | string | yes | The Core asset address (base58). |
| network | string | – | Cluster. Defaults to the configured network. |
No output schema declared.
No examples provided.
list_onchain_agents List the latest on-chain agent registrations ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| all_chains | boolean | – | Include EVM ERC-8004 registrations too. Default false (Solana only). |
| cursor | string | – | Pagination cursor from a previous call. |
| limit | integer | – | How many registrations to return. Default 12. |
| network | string | – | Solana cluster. Defaults to the configured network. |
No output schema declared.
No examples provided.
mint_onchain_agent Mint an on-chain agent into the Metaplex Agent Registry ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| active | boolean | – | Registration active flag. Default true. |
| add_blocker | boolean | – | Attach AddBlocker so no further plugins can be added. Default false. |
| attributes | array | – | On-chain Attributes plugin entries (real bytes in the asset account). |
| collection | – | – | Mint into this Metaplex Core collection. The signer must be the collection authority. |
| confirm | boolean | – | Must be true to broadcast. Anything else returns a spend-nothing preview. |
| description | string | – | What this agent is or does. Stored in the EIP-8004 registration document. |
| external_url | string | – | Optional external_url in the asset metadata (e.g. the agent home page). |
| image | string | – | Thumbnail/avatar image URL (PNG or similar). Shown on metaplex.com/agents, wallets, and explorers. |
| immutable_metadata | boolean | – | Attach the ImmutableMetadata plugin so the metadata can never change. Default true (Genesis style). |
| metadata_attributes | array | – | Off-chain attributes array inside the asset metadata JSON (trait_type/value pairs). |
| metadata_uri | string | – | Full override for the asset metadata URI (https or data:). Skips the built-in metadata builder. |
| model_url | string | – | 3D model URL (GLB). Written as the asset metadata animation_url and as model.uri in the registration, Genesis style. |
| name | string | yes | Agent name. Becomes the Core asset name and the registration name. |
| network | string | – | Solana cluster. Defaults to the configured network (mainnet unless overridden). |
| owner | string | – | Mint the asset to this owner instead of the signing wallet. |
| permanent_burn | boolean | – | Attach PermanentBurnDelegate. Default false. |
| permanent_freeze | boolean | – | Attach PermanentFreezeDelegate (unfrozen). Default false. |
| permanent_transfer | boolean | – | Attach PermanentTransferDelegate. Default false. |
| registration_uri | string | – | Full override for the Agent Identity registration URI (https or data:). Skips the built-in registration builder. |
| registrations | array | – | External registry registrations. Defaults to the chain registry entry, or the three.ws entry when threews_agent_id is set. |
| royalty_basis_points | integer | – | Royalty in basis points. Default 500 (5%), the Genesis value. 0 removes the Royalties plugin. |
| royalty_creators | array | – | Royalty split. Percentages must sum to 100. Defaults to the signing wallet at 100%. |
| secret | string | – | Per-call signing key (base58 secret key or JSON byte array). Overrides SOLANA_SECRET_KEY. |
| services | array | – | Services the agent offers, listed on its Metaplex agent page ({name, endpoint}). |
| supported_trust | array | – | Trust models the agent supports. Default ['reputation'] (Genesis style). |
| threews_agent_id | string | – | three.ws agent UUID. Adds the Genesis-exact registration entry {agentId, agentRegistry: "https://three.ws"}. |
| verified_creator | boolean | – | Attach the VerifiedCreators plugin with the signing wallet verified. Default true (Genesis style). |
| x402_support | boolean | – | Advertise x402 payment support in the registration document. Default false. |
No output schema declared.
No examples provided.
prepare_agent_mint Prepare an agent mint for a Phantom/Solflare wallet to sign ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| active | boolean | – | Registration active flag. Default true. |
| add_blocker | boolean | – | Attach AddBlocker so no further plugins can be added. Default false. |
| attributes | array | – | On-chain Attributes plugin entries (real bytes in the asset account). |
| collection | – | – | Mint into this Metaplex Core collection. The signer must be the collection authority. |
| description | string | – | What this agent is or does. Stored in the EIP-8004 registration document. |
| external_url | string | – | Optional external_url in the asset metadata (e.g. the agent home page). |
| image | string | – | Thumbnail/avatar image URL (PNG or similar). Shown on metaplex.com/agents, wallets, and explorers. |
| immutable_metadata | boolean | – | Attach the ImmutableMetadata plugin so the metadata can never change. Default true (Genesis style). |
| metadata_attributes | array | – | Off-chain attributes array inside the asset metadata JSON (trait_type/value pairs). |
| metadata_uri | string | – | Full override for the asset metadata URI (https or data:). Skips the built-in metadata builder. |
| model_url | string | – | 3D model URL (GLB). Written as the asset metadata animation_url and as model.uri in the registration, Genesis style. |
| name | string | yes | Agent name. Becomes the Core asset name and the registration name. |
| network | string | – | Solana cluster. Defaults to the configured network (mainnet unless overridden). |
| owner | string | – | Mint the asset to this owner instead of the signing wallet. |
| permanent_burn | boolean | – | Attach PermanentBurnDelegate. Default false. |
| permanent_freeze | boolean | – | Attach PermanentFreezeDelegate (unfrozen). Default false. |
| permanent_transfer | boolean | – | Attach PermanentTransferDelegate. Default false. |
| registration_uri | string | – | Full override for the Agent Identity registration URI (https or data:). Skips the built-in registration builder. |
| registrations | array | – | External registry registrations. Defaults to the chain registry entry, or the three.ws entry when threews_agent_id is set. |
| royalty_basis_points | integer | – | Royalty in basis points. Default 500 (5%), the Genesis value. 0 removes the Royalties plugin. |
| royalty_creators | array | – | Royalty split. Percentages must sum to 100. Defaults to the signing wallet at 100%. |
| services | array | – | Services the agent offers, listed on its Metaplex agent page ({name, endpoint}). |
| supported_trust | array | – | Trust models the agent supports. Default ['reputation'] (Genesis style). |
| threews_agent_id | string | – | three.ws agent UUID. Adds the Genesis-exact registration entry {agentId, agentRegistry: "https://three.ws"}. |
| verified_creator | boolean | – | Attach the VerifiedCreators plugin with the signing wallet verified. Default true (Genesis style). |
| wallet | string | yes | The base58 address of the wallet that will sign, pay, and own the agent. |
| x402_support | boolean | – | Advertise x402 payment support in the registration document. Default false. |
No output schema declared.
No examples provided.
register_agent_identity Register an existing Core asset in the Metaplex Agent Registry ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| active | boolean | – | Registration active flag. Default true. |
| asset | string | yes | The Core asset address to register. |
| collection | string | – | The collection address, required for collection-bound assets. |
| confirm | boolean | – | Must be true to broadcast. Anything else returns a preview. |
| description | string | – | Agent description. |
| image | string | – | Thumbnail image URL. |
| model_url | string | – | 3D model URL (GLB), written as model.uri. |
| name | string | yes | Agent name for the registration document. |
| network | string | – | Cluster. Defaults to the configured network. |
| registration_uri | string | – | Full override for the registration URI (https or data:). |
| registrations | array | – | External registry entries. Defaults to the chain registry entry. |
| secret | string | – | Per-call signing key. Overrides SOLANA_SECRET_KEY. |
| services | array | – | Services the agent offers. |
| supported_trust | array | – | Default ['reputation']. |
| threews_agent_id | string | – | three.ws agent UUID for the Genesis-exact three.ws registration entry. |
| x402_support | boolean | – | Advertise x402 payment support. Default false. |
No output schema declared.
No examples provided.
send_signed_transaction Broadcast signed Solana transactions in order and confirm them ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| network | string | – | Cluster to broadcast on. Defaults to the configured network. |
| tx_base64 | string | – | A single fully signed transaction, base64 encoded. |
| txs_base64 | array | – | Fully signed transactions to broadcast in order (e.g. create then register). |
No output schema declared.
No examples provided.
three_status Deploy fee, $THREE holder tier, and the live buyback ledger ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| network | string | – | Cluster. Defaults to the configured network. Devnet deploys are always free. |
| wallet | string | – | Price the deploy fee for this wallet. Defaults to the configured signer. |
No output schema declared.
No examples provided.