Verifi

Verifi

AI エージェントのための、検証済みの人間による確認ループ。 エージェントが意図と主張を POST すると、実際の人間が確認し、正しい、誤り、または自由記述の修正による改善案で回答します。支払いには、HTTP 402 のペイウォールの背後でネイティブの x402 マイクロペイメント（Base 上の USDC または EURC）を使用します。アカウントも API キーも不要です。

verifi.cloud で公開中 · API ドキュメント · llms.txt · MCP エンドポイント：https://verifi.cloud/mcp

公式 MCP Registry 名：cloud.verifi/human-verification。公開および ドメイン所有権の詳細は、docs/MCP_REGISTRY.md に記載されています。

理由

あらゆるエージェントフレームワークが同じ壁に突き当たります。エージェントは自分の出力を信頼できません。Verifi は、エージェントが支払う方法（x402）に対応した、永続的な人間による確認ワークフローを提供します。また、適切な回答に数分かかる場合でも、信頼性を保てるように設計されています。

仕組み

agent ──POST /verify──▶ verify-api ──▶ core engine ──▶ Telegram bot ──▶ human
  ▲                        │x402           │ route,        │ buttons:      │
  │                        │verify+settle  │ audit         │ ✅ ❌ ✏️       │
  └──────── answer ◀───────┴───────────────┴───────────────┴───────────────┘

• ユーロ建ての3段階料金：0.10 EUR を支払うと、リクエストが人間の対応待ちキューに入ります。受付から60分以内に人間が回答した場合、2.90 EUR を支払うと結果を取得できます。60分を過ぎてから24時間以内に回答した場合は、1.45 EUR で結果を取得できます。料金はエージェントが取得するタイミングではなく、人間が回答したタイミングによって決まり、固定されています。EURC で支払うか、ECB 参照レートで換算し、セント単位に切り上げた USDC で支払います。受付時の資産によってチェーンが決まり、すべての料金は最初の 402 に記載されます。
• 人間の作業は無料ではありません：どのチェーンでも、両方の段階で支払いが必要です。人間の時間は希少なリソースですが、ウォレットアドレスは無料で作成できるため、無料枠を設けると誰でも未払いのままキューを埋め尽くせてしまいます。人間の作業を伴わないものは無料です。ドキュメント、MCP の検出、およびエージェントが接続をテストして料金を確認できる 402 レスポンスが対象です。
• 失敗時のクレジット：受付料金が実際に支払われたチェーンで、24時間以内に誰も回答しなかった場合、次のチェーンで使える無料の受付権が1回分付与されます。資産は同じです。結果の取得料金は含まれず、人間の作業を無料で得るためにクレジットを繰り返し獲得することはできません。
• 信頼性の高い配信：すべての呼び出しで、永続的な verify_id とともに 202 が返されます。人間による対応に必要な時間に応じて、最大24時間ポーリングできます。または、オプションの準備完了コールバックもしくは失敗コールバックを利用できます。
• MCP：エージェントは verify_claim、get_verify、unlock_verify、verifi_info を直接呼び出せます。

リポジトリ構成

core/          Python core engine
  api/         internal FastAPI + admin dashboard + public /contact
  bot/         Telegram bot for human responders (associates)
  mcp/         MCP server (Streamable HTTP)
  routing/     associate selection
  payments/    earnings, settlements, payouts
  db/          PostgreSQL schema + migrations
instances/
  verify-api/  public Verify API (Node.js + @x402/express)
  ask-this-finn/  second instance (placeholder)
deploy/        docker-compose, nginx, facilitator config, static site
scripts/       ops wrapper (lock + audit + turn-taking)

1台の VPS ですべてを実行します。PostgreSQL（+pgvector）、コアエンジン、ボット、Verify API、x402 ファシリテーター、MCP サーバー、nginx が含まれます。

自分で実行する

cp deploy/env.server.example .env   # fill in tokens and keys
docker compose -f deploy/docker-compose.yml --env-file .env up -d postgres
docker compose -f deploy/docker-compose.yml --env-file .env up -d --build \
  core-api verify-api mcp
docker compose -f deploy/docker-compose.yml --env-file .env --profile bot up -d bot
docker compose -f deploy/docker-compose.yml --env-file .env --profile payments up -d facilitator
docker compose -f deploy/docker-compose.yml --env-file .env --profile edge up -d nginx

必要なもの：Telegram ボットトークン、受取用ウォレットアドレス（X402_PAY_TO）、およびファシリテーター用の少額のガス代ウォレット（FACILITATOR_PRIVATE_KEY、Base 上の ETH 数ユーロ分）。資金の仕組みについてはdocs/WALLETS.mdを、設計上の判断についてはdocs/DECISIONS.mdをご覧ください。

20秒でわかる API

curl -X POST https://verifi.cloud/verify \
  -H "Content-Type: application/json" \
  -d '{"intent": "send_email",
       "claim": "The user opted in via double opt-in on 2026-07-15.",
       "agent_id": "0xYourWalletAddress"}'

受付済みのレスポンスは、すべて 202 と status: "processing" で始まります。ready または failed になるまでポーリングしてください。結果が ready になったら、別の取得エンドポイントから取得します。正式なリポジトリのリファレンスはdocs/API.mdで、verifi.cloud/docsでもご覧いただけます。

ライセンス

MIT