Second Eyes Ai MCP Server

Second Eyes

Open infrastructure for autonomous agents. secondeyesai.com

Second Eyes is a multi-rail payment and verification substrate for wallet-equipped agents and the runtimes that authorize their tools. Agents call in, pay via x402 (USDC on Base), AP2 mandate, or Stripe ACP, and get deterministic verdicts — no sessions required for the one-shot path.

The MCP package is a thin stdio client that proxies to the substrate API. Same codebase, same repo, same product.

Protocol anchors

Session-less x402 doors (autonomous agents)

No login, no session header. Pay USDC on Base via x402 v2 (PAYMENT-REQUIRED → sign → PAYMENT-SIGNATURE). Deterministic verdicts — same answer on every retry.

Full agent-facing docs: /llms.txt. Index new routes: node scripts/canary-pay.mjs.

Payment rails (x402 v2 accepts[])

Base (eip155:8453) is canonical and always accepts[0]. Polygon (eip155:137) and Solana are roadmap — do not sign for a planned rail. Live rail states: GET /api/bar → payment_activation.rail_states. See docs/multi-network-x402.md.

Wallet-equipped agent target profiles

Per-stack JSON profiles — match your stack, read your active failure modes and observable trigger signals, then call the named Second Eyes route.

Index: public/.well-known/wallet-agent-targets/index.json

Install (agents)

{
  "mcpServers": {
    "secondeye": {
      "command": "npx",
      "args": ["-y", "@secondeyes/mcp-unblock"]
    }
  }
}

Develop

cd <project-root>
npm install
npx wrangler pages deploy public --project-name second-eyes-ai

Secrets (never commit): copy .env.example → .env.local, then node scripts/push-coinbase-secrets.mjs. Required for transcribe/extract: OPENROUTER_API_KEY.

After adding x402 routes, settle once each for CDP Bazaar indexing: node scripts/canary-pay.mjs.

Publish MCP package

From repo root, tag mcp-vX.Y.Z (or run workflow manually). Uses npm Trusted Publishing (OIDC) — configure once on npmjs.com. See packages/secondeye-mcp/PUBLISH.md.

Deprecated repo

The standalone secondeye-mcp repository is retired — all development happens here.

Terminology normalization summary (issue #40)