@three-ws/metaplex-agent-mcp

Stelle KI-Agenten on-chain im Metaplex Agent Registry auf Solana bereit – von jedem MCP-Client aus.

Ein Flow mintet ein Metaplex-Core-Asset und registriert dessen EIP-8004-Agentenidentität (eine einzige atomare Transaktion, wenn sie in Solanas 1232-Byte-Limit passt, andernfalls Create + Register in Sequenz – genau wie die Genesis 333 gelandet sind), sodass der Agent auf metaplex.com/agents mit eigener integrierter Wallet, Reputationsoberfläche und Explorer-Seiten erscheint. Die Standardausgabe reproduziert exakt die Form der three.ws-Genesis-333-Mints, byte-für-byte gegen die Live-Assets verifiziert:

• Asset-Metadaten als eigenständige data:application/json;base64-URI (name, image, animation_url GLB)

• Royalties-Plugin (5 % an den Eigentümer), VerifiedCreators (die signierende Wallet), ImmutableMetadata

• AgentIdentity-Plugin mit dem eip-8004#registration-v1-Dokument (model.uri, active, x402Support, registrations, supportedTrust)

Zwei Signier-Spuren, beide selbstverwahrend:

• Agenten signieren mit ihrem eigenen Schlüsselpaar (SOLANA_SECRET_KEY): mint_onchain_agent.

• Personen signieren mit Phantom, Solflare, Backpack, Ledger oder einer beliebigen Solana-Wallet: prepare_agent_mint baut die Transaktion, die Wallet signiert sie, send_signed_transaction sendet sie aus. Kein Schlüssel berührt jemals den Server.

Nichts ist simuliert: echte Metaplex-Programme, echtes Solana und Devnet-Support für eine kostenlose End-to-End-Generalprobe.

Installation

npm install -g @three-ws/metaplex-agent-mcp
# or run ad hoc
npx -y @three-ws/metaplex-agent-mcp

Related MCP server: AgentWallet MCP Server

Einrichtung

Claude Code:

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

Cursor / jeder MCP-Client (mcp.json):

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

SOLANA_SECRET_KEY ist optional: Jedes Lese-Tool und der gesamte Phantom/Solflare-Flow funktionieren auch ohne.

Schnellstart

Probe auf Devnet kostenlos, dann auf Mainnet:

1. agent_wallet {}                                → confirm the signer is funded
2. mint_onchain_agent { name: "Astra", description: "…",
     image: "https://…png", model_url: "https://…glb",
     x402_support: true, network: "devnet" }      → preview (nothing broadcast)
3. …same call with confirm: true                  → minted + registered, links returned
4. get_onchain_agent { asset: "<returned asset>", network: "devnet" }

Der Mint kostet ~0,007 SOL auf Mainnet (Core-Miete + Identitäts-PDA-Miete + Gebühren).

Tools

Anpassung

Jedes Feld, das der Mint berührt, ist ein Parameter: Eigentümer, Collection, Royalty-Basispunkte und -Aufteilungen, verifizierter Ersteller, unveränderliche Metadaten, On-Chain-Attribute, permanente Freeze/Transfer/Burn-Delegates, AddBlocker, Off-Chain-Metadaten-Attribute, external_url, Dienste, Vertrauensmodelle, Registrierungseinträge sowie vollständige metadata_uri-/registration_uri-Überschreibungen für selbst gehostete Dokumente. Die Standardwerte sind die Genesis-333-Werte, sodass ein Aufruf nur mit name, description, image und model_url ein Asset erzeugt, das in seiner Form von den Originalen nicht zu unterscheiden ist.

Sicherheit

• mint_onchain_agent und register_agent_identity senden nur mit confirm: true (setze REQUIRE_CONFIRM=false zum Opt-out); Vorschauen kosten nichts.

• Schlüssel bleiben bei dir: SOLANA_SECRET_KEY oder ein secret pro Aufruf, niemals eine verwahrte Wallet. Die Wallet-Spur benötigt überhaupt keinen Schlüssel.

• Guthaben werden vor Ausgaben geprüft, RPC-Endpunkte müssen HTTPS sein, und Devnet ist ein erstklassiges Ziel für die Generalprobe.

Umgebungsvariablen

Bibliotheksnutzung

Die Builder werden für die direkte Einbettung exportiert (Web-Apps, Skripte):

import { buildAgentMint, sendAgentMint, buildUmi, toBase58Signature } from '@three-ws/metaplex-agent-mcp/lib';

const umi = buildUmi({ network: 'devnet', secret: process.env.SOLANA_SECRET_KEY });
const mint = buildAgentMint(umi, {
	network: 'devnet',
	creator: umi.identity.publicKey.toString(),
	name: 'Astra',
	description: 'An autonomous 3D agent',
	image: 'https://example.com/astra.png',
	modelUrl: 'https://example.com/astra.glb',
	x402Support: true,
});
const { signatures, atomic } = await sendAgentMint(umi, mint, { toBase58Signature });

Die Registrierungs- und Metadaten-Builder sind außerdem eigenständig importierbar (abhängigkeitsfrei, browser-sicher) über @three-ws/metaplex-agent-mcp/lib/registration, und die Transaktions-Builder über @three-ws/metaplex-agent-mcp/lib/mint. Die three.ws-/deploy-onchain-Seite läuft exakt auf diesen.

Anforderungen

• Node 20+

• SOL im Zielnetzwerk zum Minten (~0,007 SOL pro Agent auf Mainnet; Devnet ist kostenlos über den Faucet)

Links

• three.ws: https://three.ws

• Live-Deployments-Feed: https://three.ws/deployments

• Metaplex Agent Registry: https://www.metaplex.com/agents

• Metaplex-Dokumentation: https://www.metaplex.com/docs/agents

• Quelle: https://github.com/nirholas/three.ws/tree/main/packages/metaplex-agent-mcp

Über dieses Repository

Dies ist die eigenständige Heimat von @three-ws/metaplex-agent-mcp. Die Entwicklung findet im three.ws-Monorepo statt, und Releases werden hierher gespiegelt, sodass dieses Repository immer dem entspricht, was auf npm und im offiziellen MCP-Registry (io.github.nirholas/metaplex-agent) veröffentlicht ist. Issues und PRs sind an beiden Orten willkommen.