Skip to main content
ArcPay Somnia has three developer-facing packages published on npm:
PackagePurposePublish directory
@arcpaylabs/somnia-cliLocal CLI for contract addresses, IDs, guides, and MCP configapps/cli
@arcpaylabs/somnia-mcpLocal stdio MCP server for Claude Desktop and compatible hostsapps/mcp
@arcpaylabs/somnia-x402-agent-starterStarter client for paid Somnia x402 agent endpointsstarter-kits/somnia-x402-agent

​
Pre-Publish Verification

npm run audit:runtime
npm run package:all
npm run build:frontend
npm run docs:check
npm run check:worker
npm run check:x402

​
Published Packages

npm view @arcpaylabs/somnia-cli version
npm view @arcpaylabs/somnia-mcp version
npm view @arcpaylabs/somnia-x402-agent-starter version
If republishing a new version, run npm version patch inside the package folder, then publish from that folder. Do not publish from the repo root.

​
Claude Desktop MCP Config

After publishing: 
{
  "mcpServers": {
    "arcpay-somnia": {
      "command": "arcpay-somnia-mcp"
    }
  }
}

​
Beta Launch Checklist

  • Create/confirm X account for ArcPay Somnia.
  • Create Telegram beta group.
  • Pin https://arcpay-somnia.vercel.app/beta as the signup link.
  • Share docs: https://arcpay-somnia.vercel.app/docs/overview.
  • Share status: https://arcpay-somnia.vercel.app/status.
  • Share x402 demo: https://x402.20.208.46.195.nip.io/x402/demo.
  • Invite agent builders to install the CLI/MCP and test paid endpoints.

​
Security Boundary

Runtime audit is clean with npm run audit:runtime. The full root audit still reports dev-only Hardhat v2/toolbox dependency findings. Those do not ship in frontend, worker, x402, MCP, or starter-kit runtime packages. A Hardhat v3 migration should be handled separately because it can change deploy/test behavior.