Verity Skills

Verity MCP サーバー

Verity のスキルを提供する公開 MCP（Model Context Protocol）サーバーです。AI エージェントが取引の前に呼び出せる 6 つのエンドポイントを備えています。協調的な活動の検出、市場の対象のスコアリング、主張の照合、偽情報のパターンの検出を行います。

本番エンドポイント： https://mcp.verityskills.com/mcp

Verity のスキルを使う理由

ApeWisdom にはダッシュボードがあります。StockTwits にはフィードがあります。Verity にはスキルがあります。多くの AI ワークフローで欠けている、取引前のインテグリティチェックです。一度接続すれば、Claude、Cursor、LangChain、LlamaIndex のワークフロー内から、Verity のすべての機能を関数呼び出しとして利用できます。

各スキルには Verity API キーが必要です。https://verityskills.com/account/api-keys で数秒で発行できます。

インストール

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。ネイティブ HTTP トランスポート（Claude Desktop 2026 ビルド）：

{
  "mcpServers": {
    "verity": {
      "type": "http",
      "url": "https://mcp.verityskills.com/mcp",
      "headers": {
        "Authorization": "Bearer vtk_<your-token>"
      }
    }
  }
}

お使いの Claude Desktop が古く、type: "http" が拒否される場合は、mcp-remote の stdio ブリッジを使用してください。詳しい手順は docs/CLAUDE_DESKTOP.md をご覧ください。再起動する前に、Claude Desktop を完全に終了（macOS では Cmd-Q）してください。

Cursor

~/.cursor/mcp.json に追加します：

{
  "mcpServers": {
    "verity": {
      "url": "https://mcp.verityskills.com/mcp",
      "headers": {
        "Authorization": "Bearer vtk_<your-token>"
      }
    }
  }
}

Cursor を再起動します。詳しい手順は docs/CURSOR.md をご覧ください。

直接 API を使用する（curl、MCP クライアント不要）

curl -sS -X POST https://mcp.verityskills.com/mcp \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer vtk_your_key_here' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "coordination-heat",
      "arguments": { "subject": "GME" }
    }
  }'

6 つすべてのスキルで、https://verityskills.com/account/api-keys から発行した API キーが必要です。

その他のエージェント実行環境

MCP に準拠するエージェント実行環境であれば、どれでも動作します。エンドポイントは HTTP+SSE 経由の https://mcp.verityskills.com/mcp です（SSE チャネルは今後追加予定です。現在は HTTP POST を利用できます）。各スキルに Authorization: Bearer vtk_<token> を追加してください。

利用可能なスキル

スキル	認証	機能
coordination-heat	必須	トピック、ティッカー、ナラティブの協調的な活動をスコアリングします。
verity-score	必須	市場の対象に対する複合インテグリティスコアです。
morning-brief	必須	ウォッチリスト全体の夜間シグナルを毎日まとめて報告します。
verity-scan	必須	トピック、ティッカー、主張をリアルタイムでスキャンします。
cross-check-alert	必須	監視対象の情報源と主張を照合します。
disinfo-alert	必須	トピックやティッカーに関する偽情報のパターンを監視します。

マーケットプレイスへの掲載

• Smithery.ai（審査待ち）
• Cursor Directory（審査待ち）
• PulseMCP、Glama、MCP.so（審査待ち）

アーキテクチャ

Cloudflare Workers 上で動作する、ベアラートークンを使用した軽量なプロキシです。状態を保持せず、DB 認証情報も不要です。

• MCP クライアントからの Authorization: Bearer vtk_* を、verityskills.com のスキルルート向けの上流 x-verity-key ヘッダーに変換します。
• MCP 仕様（2025-03-26）に準拠した JSON-RPC 2.0 フレーミングです。
• 402 TRIAL_CAP_REACHED レスポンスを書き換えて絶対パスの upgrade_url を挿入し、試用上限に達したユーザーを MCP クライアントから適切なアップグレードページに誘導できるようにします。
• 上流からの 5xx レスポンスを、HTTP 200 を伴う JSON-RPC -32603 エンベロープでラップし、トランスポート層の再試行セマンティクスを維持します。
• MCP_TOOLS_DISABLED Wrangler シークレットでツールごとにキルスイッチを設定できます。MCP_KILL_SWITCH=on で全体のキルスイッチを有効にできます。
• @sentry/cloudflare による Sentry インストルメンテーションを備えています。beforeSend フックにより、キャプチャされるすべてのイベントからベアラートークンを除去します。

運用

項目	参照先
デプロイ、シークレット、DNS	docs/DEPLOY_RUNBOOK.md
デプロイ後のスモークテスト	scripts/post-deploy-smoke.sh <base-url>
合成モニタリング	cchurctrip/verity:app/api/cron/mcp-synthetic-smoke/route.ts で 5 分ごとに実行する cron
ヘルスエンドポイント	GET https://mcp.verityskills.com/health
マーケットプレイスへの申請	docs/SMITHERY.md、docs/CURSOR.md

開発

git clone https://github.com/cchurctrip/verity-mcp
cd verity-mcp
npm install
npm test            # 237 unit + property + integration tests
npm run lint
npm run typecheck
npm run check-manifest
npx wrangler dev    # local worker on http://localhost:8787

ライセンス

MIT です。LICENSE をご覧ください。