{"_id":"@apexfusion/mcp-server","name":"@apexfusion/mcp-server","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@apexfusion/mcp-server","version":"0.1.0","main":"index.js","type":"module","bin":{"mcp-server":"build/index.js"},"scripts":{"postinstall":"ln -sf ../../../libsodium-sumo/dist/modules-sumo-esm/libsodium-sumo.mjs node_modules/libsodium-wrappers-sumo/dist/modules-sumo-esm/libsodium-sumo.mjs 2>/dev/null || true","clean":"rm -rf build","build":"tsup && chmod +x build/index.js","typecheck":"tsc --noEmit --incremental","start":"node build/index.js","test":"npm run build && node --import tsx --test test/run.test.ts"},"keywords":["vector","mcp","blockchain","cardano","apex-fusion","ai-agent","utxo"],"author":{"name":"Apex Fusion"},"license":"ISC","description":"MCP server for Vector blockchain — AI agent interface for Apex Fusion's L2","repository":{"type":"git","url":"git+https://github.com/Apex-Fusion/mcp-server.git"},"homepage":"https://github.com/Apex-Fusion/mcp-server#readme","bugs":{"url":"https://github.com/Apex-Fusion/mcp-server/issues"},"engines":{"node":">=14.0.0"},"private":false,"publishConfig":{"registry":"https://registry.npmjs.org/"},"dependencies":{"@modelcontextprotocol/sdk":"^1.4.1","cross-fetch":"^4.0.0","dotenv":"^16.4.5","@lucid-evolution/lucid":"^0.4.29","@noble/hashes":"^1.7.1","zod":"^3.24.1"},"devDependencies":{"@types/node":"^22.13.1","tsup":"^8.5.1","tsx":"^4.21.0","typescript":"^5.7.3"},"_id":"@apexfusion/mcp-server@0.1.0","gitHead":"96a2d12005bbac7fc33ee148e1a0bc803d7d43ac","_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-OJF7PWskbkNZnsNd3ULZOzDmRjvruAbFulNEk+QHTlVm4W521XhIysww0aKVMjnFs3lOBg82lBw+ammhNdwUsA==","shasum":"229df77d53d2120afaa3484eb624099b708c8526","tarball":"https://registry.npmjs.org/@apexfusion/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":4,"unpackedSize":113235,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBtO62nTvi36U/xJ0kCK82hI/Rpe+xedoke7/v2FldyGAiEA127bSXur6FBE6pzCnX5TzwIpahsMlnuzlUbc822lRVc="}]},"_npmUser":{"name":"apexfusion","email":"security@hal8.io"},"directories":{},"maintainers":[{"name":"apexfusion","email":"security@hal8.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.0_1773999191493_0.0946752833380502"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-20T09:33:11.421Z","0.1.0":"2026-03-20T09:33:11.637Z","modified":"2026-03-20T09:33:11.812Z"},"maintainers":[{"name":"apexfusion","email":"security@hal8.io"}],"description":"MCP server for Vector blockchain — AI agent interface for Apex Fusion's L2","homepage":"https://github.com/Apex-Fusion/mcp-server#readme","keywords":["vector","mcp","blockchain","cardano","apex-fusion","ai-agent","utxo"],"repository":{"type":"git","url":"git+https://github.com/Apex-Fusion/mcp-server.git"},"author":{"name":"Apex Fusion"},"bugs":{"url":"https://github.com/Apex-Fusion/mcp-server/issues"},"license":"ISC","readme":"# Vector MCP Server\n\nMCP (Model Context Protocol) server for the **Vector blockchain** — Apex Fusion's UTXO-based L2. Enables AI agents (Claude, GPT, Gemini, or any MCP client) to interact with Vector natively: query balances, send transactions, deploy and interact with smart contracts, and manage on-chain AI agent identities.\n\nBuilt on [Ogmios](https://ogmios.dev/) + [Koios](https://www.koios.rest/) — no Blockfrost dependency.\n\n## Features\n\n- **Wallet management** — derive addresses from mnemonic, query balances and UTxOs\n- **Transactions** — send ADA and native tokens, build multi-output transactions, dry-run simulations\n- **Smart contracts** — deploy Plutus/Aiken validators, lock and spend UTxOs at script addresses\n- **Agent registry** — register, discover, update, transfer, and deregister on-chain AI agent identities via soulbound NFTs\n- **Agent messaging** — send on-chain messages between agents via TX metadata\n- **Safety controls** — per-transaction and daily spend limits, persistent audit log, rate limiting\n- **SSE transport** — HTTP server with Server-Sent Events for MCP client connectivity\n\n## MCP Tools\n\n### Wallet & Queries\n\n| Tool | Description |\n|------|-------------|\n| `vector_get_balance` | Get ADA and token balances for any address |\n| `vector_get_address` | Get the wallet address, balance, and holdings from a mnemonic |\n| `vector_get_utxos` | List UTxOs for an address or wallet |\n| `vector_get_spend_limits` | Check spend limits, daily usage, and audit log |\n| `vector_get_transaction_history` | Get transaction history for a wallet |\n\n### Transactions\n\n| Tool | Description |\n|------|-------------|\n| `vector_send_apex` | Send ADA (respects spend limits) |\n| `vector_send_tokens` | Send native tokens with optional ADA |\n| `vector_build_transaction` | Build multi-output transactions (sign+submit or return unsigned CBOR) |\n| `vector_dry_run` | Simulate a transaction without submitting — estimate fees and validate |\n\n### Smart Contracts\n\n| Tool | Description |\n|------|-------------|\n| `vector_deploy_contract` | Deploy a Plutus V1/V2/V3 or Aiken validator to the chain |\n| `vector_interact_contract` | Lock ADA at a script address or spend from it with a redeemer |\n\n### Agent Registry\n\n| Tool | Description |\n|------|-------------|\n| `vector_register_agent` | Register an agent — mints a soulbound identity NFT and locks a 10 AP3X deposit |\n| `vector_discover_agents` | Discover registered agents, filter by capability or framework (no wallet needed) |\n| `vector_get_agent_profile` | Get an agent's full profile by DID (no wallet needed) |\n| `vector_update_agent` | Update an agent's name, description, capabilities, framework, or endpoint |\n| `vector_transfer_agent` | Transfer agent ownership to a new address |\n| `vector_deregister_agent` | Deregister an agent — burns the identity NFT and returns the 10 AP3X deposit |\n| `vector_message_agent` | Send an on-chain message to an agent via TX metadata (label 674) |\n\nAgent DIDs follow the format: `did:vector:agent:{policyId}:{nftAssetName}`\n\n## Quick Start\n\n### 1. Install and build\n\n```bash\nnpm install\nnpm run build\n```\n\n### 2. Configure environment (optional)\n\n```bash\ncp .env.example .env\n# Edit .env with your endpoint URLs (defaults point to Vector testnet)\n```\n\nThe mnemonic is passed per-call by the MCP client, not stored in the environment.\n\n### 3. Run\n\n```bash\nnpm start\n# Server listens on port 3000 (configurable via PORT env var)\n```\n\n### 4. Add to Claude Desktop\n\nAdd to your Claude Desktop MCP config (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"vector\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/vector-mcp-server/build/index.js\"],\n      \"env\": {\n        \"VECTOR_OGMIOS_URL\": \"https://ogmios.vector.testnet.apexfusion.org\",\n        \"VECTOR_SUBMIT_URL\": \"https://submit.vector.testnet.apexfusion.org/api/submit/tx\",\n        \"VECTOR_KOIOS_URL\": \"https://koios.vector.testnet.apexfusion.org/\",\n        \"VECTOR_EXPLORER_URL\": \"https://vector.testnet.apexscan.org\"\n      }\n    }\n  }\n}\n```\n\n### Docker\n\n```bash\nnpm run build\ndocker build -t vector-mcp .\ndocker run -p 3000:3000 vector-mcp\n```\n\n## Configuration\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `PORT` | HTTP server port | `3000` |\n| `VECTOR_OGMIOS_URL` | Ogmios HTTP JSON-RPC endpoint | `https://ogmios.vector.testnet.apexfusion.org` |\n| `VECTOR_KOIOS_URL` | Koios REST API endpoint | `https://koios.vector.testnet.apexfusion.org/` |\n| `VECTOR_SUBMIT_URL` | Transaction submit API | `https://submit.vector.testnet.apexfusion.org/api/submit/tx` |\n| `VECTOR_EXPLORER_URL` | Block explorer base URL | `https://vector.testnet.apexscan.org` |\n| `VECTOR_SPEND_LIMIT_PER_TX` | Max lovelace per transaction | `100000000` (100 ADA) |\n| `VECTOR_SPEND_LIMIT_DAILY` | Max lovelace per day | `500000000` (500 ADA) |\n| `VECTOR_AUDIT_LOG_PATH` | Persistent audit log file path | `./vector-audit-log.json` |\n| `VECTOR_RATE_LIMIT_PER_MINUTE` | Max tool calls per minute | `60` |\n\n## Testing\n\n```bash\n# Set the wallet mnemonic (file or env var)\necho \"your mnemonic words here\" > mnemonic.txt\n# or: export VECTOR_MNEMONIC=\"your mnemonic words here\"\n\nnpm test\n```\n\nTests cover all 18 tools end-to-end against Vector testnet, including the full agent lifecycle: register, discover, profile, update, transfer, message, and deregister.\n\n## Architecture\n\n```\n┌──────────────────────┐      ┌──────────────────────────┐\n│  Claude / GPT / etc. │◄────►│  vector-mcp-server       │\n│  (any MCP client)    │ SSE  │                          │\n└──────────────────────┘      │  ┌────────────────────┐  │\n                              │  │ Rate Limiter        │  │\n                              │  │ (60 calls/min)      │  │\n                              │  └────────┬───────────┘  │\n                              │           │               │\n                              │  ┌────────▼───────────┐  │\n                              │  │ Safety Layer        │  │\n                              │  │ - Per-tx limits     │  │\n                              │  │ - Daily limits      │  │\n                              │  │ - Audit log         │  │\n                              │  └────────┬───────────┘  │\n                              │           │               │\n                              │  ┌────────▼───────────┐  │\n                              │  │ Lucid + Ogmios     │  │\n                              │  │ Provider            │  │\n                              │  └────────┬───────────┘  │\n                              │           │               │\n                              │  ┌────────▼───────────┐  │\n                              │  │ Ogmios / Koios /   │  │\n                              │  │ Submit API          │  │\n                              │  └────────────────────┘  │\n                              └──────────────────────────┘\n```\n\n## About Vector\n\nVector is Apex Fusion's UTXO-based L2 blockchain, running with Cardano's mainnet parameters. It provides near-instant finality and 4x Cardano throughput, making it ideal for AI agent interactions.\n\n- **Explorer:** https://vector.testnet.apexscan.org\n- **Apex Fusion:** https://apexfusion.org\n","readmeFilename":"README.md","_rev":"1-c6ad310cbab6a59e3d0af368a111bd02"}