{"_id":"@arcpaylabs/somnia-mcp","_rev":"7-8b9671af61b12574bc4727e7d26eb09f","name":"@arcpaylabs/somnia-mcp","dist-tags":{"latest":"0.1.7"},"versions":{"0.1.0":{"name":"@arcpaylabs/somnia-mcp","version":"0.1.0","author":{"name":"Henry Sammarfo","email":"jasonneil4040@gmail.com"},"license":"MIT","_id":"@arcpaylabs/somnia-mcp@0.1.0","maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"homepage":"https://arcpay-somnia.vercel.app/docs/mcp","bugs":{"url":"https://github.com/ArcPayLabs/arcpay-somnia/issues"},"bin":{"arcpay-somnia-mcp":"server.mjs"},"dist":{"shasum":"984807fd2b7ecdc7075d543173257d662eccebc9","tarball":"https://registry.npmjs.org/@arcpaylabs/somnia-mcp/-/somnia-mcp-0.1.0.tgz","fileCount":4,"integrity":"sha512-8Nkqn5EcdgErKDlKhRFJ2ylM+QyjAbvFSnQxYv2jd1brLwe98FzaWyAEGOd5rGHEg74RugvyYI0gHxaJWghWOA==","signatures":[{"sig":"MEQCIG2RGwDq+p7LoMBDyL/IXAUAy8lv4zogLr9O6Q4OWR6sAiAtCa0JoVeyNq63a/7z9/sdS13Ip8iPnw8gG2PYzJC4yA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8985},"type":"module","gitHead":"f677a172886b4c9c4e4e2dae93836c858d143e8e","private":false,"scripts":{"start":"node server.mjs","pack:dry":"npm pack --dry-run"},"_npmUser":{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"},"overrides":{"ws":"^8.20.1"},"repository":{"url":"git+https://github.com/ArcPayLabs/arcpay-somnia.git","type":"git","directory":"apps/mcp"},"_npmVersion":"11.6.0","description":"MCP server for ArcPay Somnia contracts, x402, privacy intents, invoices, and demo flows.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^3.25.76","ethers":"^6.13.5","@modelcontextprotocol/sdk":"^1.18.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/somnia-mcp_0.1.0_1779953348813_0.7592120081920137","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@arcpaylabs/somnia-mcp","version":"0.1.1","author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"license":"MIT","_id":"@arcpaylabs/somnia-mcp@0.1.1","maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"homepage":"https://arcpay-somnia.vercel.app/docs/mcp","bugs":{"url":"https://github.com/ArcPayLabs/arcpay-somnia/issues"},"bin":{"arcpay-somnia-mcp":"server.mjs"},"dist":{"shasum":"4146bf89ca4248af4e35533cb9fef450dd17b265","tarball":"https://registry.npmjs.org/@arcpaylabs/somnia-mcp/-/somnia-mcp-0.1.1.tgz","fileCount":4,"integrity":"sha512-ZA0w+/mAPaZaFPNMiAs7gi8LM5q5e0g/gj0D07tUr7E0jhMzcVcDGIllQYjeGX25xL6o2De6c2z/d/ZKge9EsA==","signatures":[{"sig":"MEUCIQDJHxCzO+nHlHCFlKxEe9i9QvFXVgbmcH53l3zC/ilHywIgApU8u6RgUm5HT//WHMdGUKwifcZTQc8MPd24Lhw6f2Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8986},"type":"module","gitHead":"b258e5e74e138c12e4050aeb09fea773308bc748","private":false,"scripts":{"start":"node server.mjs","pack:dry":"npm pack --dry-run"},"_npmUser":{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"},"overrides":{"ws":"^8.20.1"},"repository":{"url":"git+https://github.com/ArcPayLabs/arcpay-somnia.git","type":"git","directory":"apps/mcp"},"_npmVersion":"11.6.0","description":"MCP server for ArcPay Somnia contracts, x402, privacy intents, invoices, and demo flows.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^3.25.76","ethers":"^6.13.5","@modelcontextprotocol/sdk":"^1.18.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/somnia-mcp_0.1.1_1779968273364_0.8932007019462607","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@arcpaylabs/somnia-mcp","version":"0.1.2","author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"license":"MIT","_id":"@arcpaylabs/somnia-mcp@0.1.2","maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"homepage":"https://arcpay-somnia.vercel.app/docs/mcp","bugs":{"url":"https://github.com/ArcPayLabs/arcpay-somnia/issues"},"bin":{"arcpay-somnia-mcp":"server.mjs"},"dist":{"shasum":"af4516a17c5aef73d976ffb86768a43d56f98edb","tarball":"https://registry.npmjs.org/@arcpaylabs/somnia-mcp/-/somnia-mcp-0.1.2.tgz","fileCount":4,"integrity":"sha512-Sx1fX3bzuZk579LJIY+LOA0mdabGPUIDlezsxH/PLDO4bU0wb9fwZ5vfenCjT8oirogLWmhUK9AAO/+YomogzA==","signatures":[{"sig":"MEQCIFT0htsTi3fWcsx9MbQeF6cjPhve5eXotuvadVkX8mSuAiB9HtAx2GBceL11FMyeEshqcO3s3y4QDSfe7CjMwZCavA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8986},"type":"module","gitHead":"b258e5e74e138c12e4050aeb09fea773308bc748","private":false,"scripts":{"start":"node server.mjs","pack:dry":"npm pack --dry-run"},"_npmUser":{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"},"overrides":{"ws":"^8.20.1"},"repository":{"url":"git+https://github.com/ArcPayLabs/arcpay-somnia.git","type":"git","directory":"apps/mcp"},"_npmVersion":"11.6.0","description":"MCP server for ArcPay Somnia contracts, x402, privacy intents, invoices, and demo flows.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^3.25.76","ethers":"^6.13.5","@modelcontextprotocol/sdk":"^1.18.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/somnia-mcp_0.1.2_1779968693123_0.5935794722288741","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@arcpaylabs/somnia-mcp","version":"0.1.4","author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"license":"MIT","_id":"@arcpaylabs/somnia-mcp@0.1.4","maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"homepage":"https://arcpay-somnia.vercel.app/docs/mcp","bugs":{"url":"https://github.com/ArcPayLabs/arcpay-somnia/issues"},"bin":{"arcpay-somnia-mcp":"server.mjs"},"dist":{"shasum":"50e0d2e259fef930d6c9281afddd20f977046ec6","tarball":"https://registry.npmjs.org/@arcpaylabs/somnia-mcp/-/somnia-mcp-0.1.4.tgz","fileCount":4,"integrity":"sha512-YNPTQ3x/OG/5Oee2BUETxIp0QiOsYMUkKvmkWnb9ggztbt8B0tQTWxdQ2txKCN9a+omh3wiV+DggKnv55VAYxA==","signatures":[{"sig":"MEUCIDXAmEsUS+cyXOFz0oVom0Zl0VKoVJvMNgFHV/EK0SJhAiEAyRf2U1plFl3Wu0troK9oC5+wbmB74ynFurmzV25qzGs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10370},"type":"module","gitHead":"16c158d558c5bd3bf27f323f02d9df9a46b98eb8","private":false,"scripts":{"start":"node server.mjs","pack:dry":"npm pack --dry-run"},"_npmUser":{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"},"overrides":{"ws":"^8.20.1"},"repository":{"url":"git+https://github.com/ArcPayLabs/arcpay-somnia.git","type":"git","directory":"apps/mcp"},"_npmVersion":"11.6.0","description":"MCP server for ArcPay Somnia contracts, x402, privacy intents, invoices, and demo flows.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^3.25.76","ethers":"^6.13.5","@modelcontextprotocol/sdk":"^1.18.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/somnia-mcp_0.1.4_1780356340011_0.6957647254342181","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@arcpaylabs/somnia-mcp","version":"0.1.5","author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"license":"MIT","_id":"@arcpaylabs/somnia-mcp@0.1.5","maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"homepage":"https://arcpay-somnia.vercel.app/docs/mcp","bugs":{"url":"https://github.com/ArcPayLabs/arcpay-somnia/issues"},"bin":{"arcpay-somnia-mcp":"server.mjs"},"dist":{"shasum":"35fdbf9dde4fe4f0eb4fcaca666c7e102c364027","tarball":"https://registry.npmjs.org/@arcpaylabs/somnia-mcp/-/somnia-mcp-0.1.5.tgz","fileCount":4,"integrity":"sha512-XeIf0+GYlQvqcxsxIqeX+iZVN7bChqVRZrwgD+o/9AfeJyEjekmsnxzLAoq1yU2p1ZtBjorq/Qlit+hqW4U7mg==","signatures":[{"sig":"MEQCIGwrD8y/5cSwRpJ3TzYJwR599+hw79lL8Hi68t9jBPOyAiB8RgxWpn51x58v4h6Vl1hY9xWq/1pxKUfaSTE3uz20Rw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10679},"type":"module","gitHead":"974a260afaf3fc456e989d1475a7578e9e2902ec","private":false,"scripts":{"start":"node server.mjs","pack:dry":"npm pack --dry-run"},"_npmUser":{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"},"overrides":{"ws":"^8.20.1"},"repository":{"url":"git+https://github.com/ArcPayLabs/arcpay-somnia.git","type":"git","directory":"apps/mcp"},"_npmVersion":"11.6.0","description":"MCP server for ArcPay Somnia contracts, x402, privacy intents, invoices, and demo flows.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^3.25.76","ethers":"^6.13.5","@modelcontextprotocol/sdk":"^1.18.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/somnia-mcp_0.1.5_1780389383131_0.25069592842964084","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@arcpaylabs/somnia-mcp","version":"0.1.6","author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"license":"MIT","_id":"@arcpaylabs/somnia-mcp@0.1.6","maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"homepage":"https://arcpay-somnia.vercel.app/docs/mcp","bugs":{"url":"https://github.com/ArcPayLabs/arcpay-somnia/issues"},"bin":{"arcpay-somnia-mcp":"server.mjs"},"dist":{"shasum":"0320ba3ea5e7742cf73c1176bad7da2e074f4661","tarball":"https://registry.npmjs.org/@arcpaylabs/somnia-mcp/-/somnia-mcp-0.1.6.tgz","fileCount":4,"integrity":"sha512-jfpwX1P3z5QD+LnYHkpWaXKKTNVRQ9l/aRMNbrKNWXTwnTENuuToAVBVgyJU1VaP1enLuhGNmT+5oTDpCVrkUA==","signatures":[{"sig":"MEQCIHP9J94qJbY+N1Wwd9pjLMyDnYCiT3mwV4u1eWBG7nEcAiBWHQCJoj+5lPiVKf8ea+36gcVac7eJdiAUdGih9exl+A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12490},"type":"module","gitHead":"c616d21f6b55a31ba5fc60a12067a9b49e8df1c3","private":false,"scripts":{"start":"node server.mjs","pack:dry":"npm pack --dry-run"},"_npmUser":{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"},"overrides":{"ws":"^8.20.1"},"repository":{"url":"git+https://github.com/ArcPayLabs/arcpay-somnia.git","type":"git","directory":"apps/mcp"},"_npmVersion":"11.6.0","description":"MCP server for ArcPay Somnia contracts, x402, privacy intents, invoices, and demo flows.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^3.25.76","ethers":"^6.13.5","@modelcontextprotocol/sdk":"^1.18.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/somnia-mcp_0.1.6_1780600013815_0.9561047112503711","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@arcpaylabs/somnia-mcp","version":"0.1.7","private":false,"description":"MCP server for ArcPay Somnia contracts, x402, privacy intents, invoices, and demo flows.","type":"module","license":"MIT","author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"homepage":"https://arcpay-somnia.vercel.app/docs/mcp","repository":{"type":"git","url":"git+https://github.com/ArcPayLabs/arcpay-somnia.git","directory":"apps/mcp"},"bin":{"arcpay-somnia-mcp":"server.mjs"},"publishConfig":{"access":"public"},"scripts":{"start":"node server.mjs","pack:dry":"npm pack --dry-run"},"dependencies":{"@modelcontextprotocol/sdk":"^1.18.2","ethers":"^6.13.5","zod":"^3.25.76"},"overrides":{"ws":"^8.20.1"},"_id":"@arcpaylabs/somnia-mcp@0.1.7","gitHead":"6bff146af63c125760dc31fa78e39844645bbc38","bugs":{"url":"https://github.com/ArcPayLabs/arcpay-somnia/issues"},"_nodeVersion":"22.17.1","_npmVersion":"11.6.0","dist":{"integrity":"sha512-itZOjBbthFW7BnuvbUJcNjGyG2IVu1zGHD0oL1XCf1oNiUJyL9RPuEpZGrSfn/6qgmY3ppB4pzT6UX9iSSwBUg==","shasum":"893ef6881072569966062a505d1066ad7fbb2d7a","tarball":"https://registry.npmjs.org/@arcpaylabs/somnia-mcp/-/somnia-mcp-0.1.7.tgz","fileCount":4,"unpackedSize":18385,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIERZmCY5+4byqXkcdD6JO5pJkJNTEddVZiHuWK/Mr+HHAiEAuqm8YDdFEvKtm5Pph5tLNBs0+tmVchFbxJnT/NZYWl8="}]},"_npmUser":{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"},"directories":{},"maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/somnia-mcp_0.1.7_1781138672137_0.843984107824673"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-28T07:29:08.699Z","modified":"2026-06-11T00:44:32.436Z","0.1.0":"2026-05-28T07:29:08.954Z","0.1.1":"2026-05-28T11:37:53.502Z","0.1.2":"2026-05-28T11:44:53.270Z","0.1.4":"2026-06-01T23:25:40.145Z","0.1.5":"2026-06-02T08:36:23.267Z","0.1.6":"2026-06-04T19:06:53.943Z","0.1.7":"2026-06-11T00:44:32.278Z"},"bugs":{"url":"https://github.com/ArcPayLabs/arcpay-somnia/issues"},"author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"license":"MIT","homepage":"https://arcpay-somnia.vercel.app/docs/mcp","repository":{"type":"git","url":"git+https://github.com/ArcPayLabs/arcpay-somnia.git","directory":"apps/mcp"},"description":"MCP server for ArcPay Somnia contracts, x402, privacy intents, invoices, and demo flows.","maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"readme":"# ArcPay Somnia MCP\n\nArcPay Somnia MCP is ArcPay for AI agents. Claude Desktop, Codex-compatible hosts, and other MCP clients can ask ArcPay for Somnia deployment data, derive agent and invoice IDs, prepare x402 paid-resource flows, generate privacy/invoice instructions, inspect official Somnia Agents receipt rules, inspect Somnia DeFi adapter requirements, and return evidence checklists before claiming any work is complete.\n\n## Install\n\n```bash\nnpm install -g @arcpaylabs/somnia-mcp\n```\n\n## Claude Desktop\n\nAdd this to your Claude Desktop MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"arcpay-somnia\": {\n      \"command\": \"arcpay-somnia-mcp\"\n    }\n  }\n}\n```\n\nRestart Claude Desktop after editing the config.\n\n## Tools\n\n- `get_deployment`\n- `derive_agent_id`\n- `derive_invoice_id`\n- `derive_claim_hash`\n- `derive_privacy_commitment`\n- `privacy_intent_guide`\n- `invoice_guide`\n- `x402_guide`\n- `agent_onboarding_payload`\n- `somusd_card_plan`\n- `policy_plan`\n- `evidence_template`\n- `somnia_defi_adapters`\n- `somnia_agents`\n- `demo_path`\n- `smoke_commands`\n\n## Hosted Surfaces\n\n- App: https://arcpay-somnia.vercel.app\n- Docs: https://arcpay-somnia.vercel.app/docs/overview\n- OpenAPI: https://arcpay-somnia.vercel.app/openapi.json\n- llms.txt: https://arcpay-somnia.vercel.app/llms.txt\n- x402: https://x402.20.208.46.195.nip.io\n- Somnia Agents status: https://arcpay-somnia.vercel.app/api/somnia/agents/status\n\nThe MCP server makes ArcPay usable by agents directly, not only by humans clicking a dashboard. It does not sign transactions or mutate treasury state; it returns deterministic IDs, integration guidance, handoff payloads, and public deployment metadata that an operator can verify before execution.\n\n## Agent-Native Flows\n\n`agent_onboarding_payload` lets Claude/Codex/custom agents request the same onboarding payload a dashboard user gets: agent id, x402 endpoint, contract map, policy requirements, and claim-code steps.\n\n`somusd_card_plan` lets an agent or developer prepare card issuance without touching the dashboard. It returns the card id, vault/token contracts, call sequence, and proof requirements for create/top-up/spend.\n\n`policy_plan` returns both global workspace controls and per-agent controls, so an agent can explain what it is allowed to do before attempting any paid or money-moving action.\n\n`evidence_template` is the guardrail: it tells the agent exactly what hashes, API responses, receipts, and screenshots are required before it can claim completion.\n","readmeFilename":"README.md"}