> ## Documentation Index
> Fetch the complete documentation index at: https://arcpay-somnia.vercel.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Publish Checklist

> Release checklist for ArcPay Somnia developer packages, MCP, beta launch, and runtime security.

ArcPay Somnia has three developer-facing packages published on npm:

| Package                                 | Purpose                                                        | Publish directory                |
| --------------------------------------- | -------------------------------------------------------------- | -------------------------------- |
| `@arcpaylabs/somnia-cli`                | Local CLI for contract addresses, IDs, guides, and MCP config  | `apps/cli`                       |
| `@arcpaylabs/somnia-mcp`                | Local stdio MCP server for Claude Desktop and compatible hosts | `apps/mcp`                       |
| `@arcpaylabs/somnia-x402-agent-starter` | Starter client for paid Somnia x402 agent endpoints            | `starter-kits/somnia-x402-agent` |

## Pre-Publish Verification

```bash theme={null}
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

```bash theme={null}
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:

```json theme={null}
{
  "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.