{
  "markdown": "# Second Eyes\n\n**Open infrastructure for autonomous agents.** [secondeyesai.com](https://secondeyesai.com)\n\nSecond 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.\n\n| Surface | Location |\n|---------|----------|\n| **Live API + site** | `/` — Cloudflare Pages (`wrangler pages deploy public`) |\n| **MCP npm package** | `packages/secondeye-mcp` — `@secondeyes/mcp-unblock` |\n| **Agent entry** | `GET https://secondeyesai.com/api/bar` |\n| **Agent instructions** | [`public/llms.txt`](public/llms.txt) — how to pay, service catalog, one-shot routes |\n| **Help-me JSON packet** | [`public/.well-known/help-me.json`](public/.well-known/help-me.json) — machine-readable distress entry route |\n| **Agent card** | [`public/.well-known/agent-card.json`](public/.well-known/agent-card.json) |\n| **Crawler policy** | [`public/robots.txt`](public/robots.txt) |\n\nThe MCP package is a thin stdio client that proxies to the substrate API. Same codebase, same repo, same product.\n\n## Protocol anchors\n\n| Layer | Protocol | Role |\n|-------|----------|------|\n| Identity / Reputation | ERC-8004 | Open registry — anyone queryable |\n| Payments | x402 (USDC / Base) | Default machine rail — open HTTP 402, no allowlist |\n| Payments | AP2 + VDC mandates | Gates internal ephemeral spawn only |\n| Payments | Stripe ACP | Human or low-trust agent checkout |\n| Discovery | x402 Bazaar / CDP | Substrate endpoints registered publicly |\n| Transport | A2A / MCP | Existing |\n\n## Session-less x402 doors (autonomous agents)\n\nNo login, no session header. Pay USDC on Base via x402 v2 (`PAYMENT-REQUIRED` → sign → `PAYMENT-SIGNATURE`). Deterministic verdicts — same answer on every retry.\n\n| Door | Path | Price |\n|------|------|-------|\n| **help-me** (canonical meta-tool — looping, schema mismatch, context pressure, crash, handoff failure, wallet/spend-policy, grounding risk, auth/tool/sandbox failure, payment uncertainty) | `/api/bar/x402/help-me` | $0.01 |\n| AWS AgentCore one-shot map | `/api/bar/x402/aws-agent-survival` | $0.01 |\n| `peril-router` (legacy alias of help-me) | `/api/bar/x402/peril-router` | $0.01 |\n| Schema repair | `/api/bar/x402/schema-repair` | $0.03 |\n| Context pressure (alias: token-pressure) | `/api/bar/x402/context-pressure` | $0.03 |\n| Payment confirmation check | `/api/bar/x402/payment-confirmation-check` | $0.01 |\n| Specialist one-shot routes | `/api/bar/x402/{slug}` | $0.01–$0.05 |\n| Transcribe (audio/video/PDF) + meaning | `/api/bar/x402/transcribe` | $0.05 |\n| Doc extract (invoice/contract/PDF) | `/api/bar/x402/extract` | $0.05 |\n| Bazaar index check | `/api/bar/x402/index-check` | $0.05 |\n| x402 format doctor | `/api/bar/x402/doctor` | $0.25 |\n\nFull agent-facing docs: **`/llms.txt`**. Index new routes: `node scripts/canary-pay.mjs`.\n\n### Payment rails (x402 v2 `accepts[]`)\n\nBase (`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`](docs/multi-network-x402.md).\n\n## Wallet-equipped agent target profiles\n\nPer-stack JSON profiles — match your stack, read your active failure modes and observable trigger signals, then call the named Second Eyes route.\n\nIndex: [`public/.well-known/wallet-agent-targets/index.json`](public/.well-known/wallet-agent-targets/index.json)\n\n| Target | Profile |\n|--------|---------|\n| Coinbase AgentKit + CDP + x402 | `/.well-known/wallet-agent-targets/coinbase-agentkit-cdp.json` |\n| AWS AgentCore Payments + Strands | `/.well-known/wallet-agent-targets/agentcore-strands.json` |\n| MCP clients with spending wallets | `/.well-known/wallet-agent-targets/mcp-spending-wallets.json` |\n| Crossmint / Privy / Turnkey signer infra | `/.well-known/wallet-agent-targets/wallet-infra-crossmint-privy-turnkey.json` |\n| LangGraph / CrewAI / AutoGen / OpenAI SDK + wallets | `/.well-known/wallet-agent-targets/langgraph-crewai-openai-wallets.json` |\n| x402-native (ClawRouter / BlockRun / Zerion) | `/.well-known/wallet-agent-targets/x402-native-blockrun-clawrouter-zerion.json` |\n\n## Install (agents)\n\n```json\n{\n  \"mcpServers\": {\n    \"secondeye\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@secondeyes/mcp-unblock\"]\n    }\n  }\n}\n```\n\n## Develop\n\n```bash\ncd <project-root>\nnpm install\nnpx wrangler pages deploy public --project-name second-eyes-ai\n```\n\nSecrets (never commit): copy `.env.example` → `.env.local`, then `node scripts/push-coinbase-secrets.mjs`. Required for transcribe/extract: `OPENROUTER_API_KEY`.\n\nAfter adding x402 routes, settle once each for CDP Bazaar indexing: `node scripts/canary-pay.mjs`.\n\n## Publish MCP package\n\nFrom 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`.\n\n## Deprecated repo\n\nThe standalone [secondeye-mcp](https://github.com/This-Is-Hellgate/secondeye-mcp) repository is retired — all development happens here.\n\n## Terminology normalization summary (issue #40)\n\n| Before | After |\n|---|---|\n| Anthropomorphic route label | Canonical slug-style route label |\n| Theatrical route wording | Technical route wording |\n| Prepper/theatrical route-group wording | Specialist one-shot route-set wording |\n| Legacy catalog wording | Service-catalog wording |\n",
  "bytes": 5560,
  "sha": "c081f20c7fefb590f885c8179ebf2c90ee22927f7110911f4c1d9cddf239bf6a",
  "repo_slug": "this-is-hellgate/second-eyes-ai",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_this_is_hellgate_secondeye_mcp_7ef9bd0a/readme"
}