Verity MCP Server

Public MCP (Model Context Protocol) server for Verity skills. Six callable endpoints your AI agent can invoke before any trade: detect coordinated activity, score market subjects, cross-check claims, flag disinformation patterns.

Production endpoint: https://mcp.verityskills.com/mcp

Why Verity skills

ApeWisdom has a dashboard. StockTwits has a feed. Verity has skills. The pre-trade integrity check most AI workflows are missing. Connect once; every Verity capability becomes a function call from inside your Claude, Cursor, LangChain, or LlamaIndex workflow.

Every skill needs a Verity API key. Issue one in seconds at https://verityskills.com/account/api-keys.

Install

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). Native HTTP transport (Claude Desktop 2026 builds):

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

If your Claude Desktop is older and rejects type: "http", use the mcp-remote stdio bridge. See docs/CLAUDE_DESKTOP.md for the full guide. Fully quit Claude Desktop (Cmd-Q on macOS) before relaunch.

Cursor

Add to ~/.cursor/mcp.json:

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

Restart Cursor. See docs/CURSOR.md for the full guide.

Direct API (curl, no MCP client required)

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" }
    }
  }'

All six skills require an API key issued at https://verityskills.com/account/api-keys.

Other agent runtimes

Any MCP-compliant agent runtime works. The endpoint is https://mcp.verityskills.com/mcp over HTTP+SSE (the SSE channel is a future addition; HTTP POST works today). Add Authorization: Bearer vtk_<token> for every skill.

Available skills

Skill	Auth	Capability
`coordination-heat`	Required	Score a topic, ticker, or narrative for coordinated activity.
`verity-score`	Required	Composite integrity score for a market subject.
`morning-brief`	Required	Daily briefing of overnight signals across a watchlist.
`verity-scan`	Required	Real-time scan of a topic, ticker, or claim.
`cross-check-alert`	Required	Cross-reference a claim against monitored sources.
`disinfo-alert`	Required	Monitor a topic or ticker for disinformation patterns.

Marketplace listings

Smithery.ai (pending review)
Cursor Directory (pending review)
PulseMCP, Glama, MCP.so (pending review)

Architecture

Thin bearer-token proxy on Cloudflare Workers. Zero state, zero DB credentials.

Translates Authorization: Bearer vtk_* from MCP clients into the upstream x-verity-key header for verityskills.com skill routes.
JSON-RPC 2.0 framing per the MCP spec (2025-03-26).
402 TRIAL_CAP_REACHED responses are rewritten to inject an absolute upgrade_url so MCP clients can route trial-cap users to the right upgrade page.
5xx upstream responses are wrapped as JSON-RPC -32603 envelopes with HTTP 200 to keep transport-layer retry semantics correct.
Per-tool kill switch via the MCP_TOOLS_DISABLED Wrangler secret. Global kill switch via MCP_KILL_SWITCH=on.
Sentry instrumentation via @sentry/cloudflare. Bearer tokens are scrubbed from any captured event via a beforeSend hook.

Operations

Concern	Source
Deploy + secrets + DNS	`docs/DEPLOY_RUNBOOK.md`
Post-deploy smoke	`scripts/post-deploy-smoke.sh <base-url>`
Synthetic monitoring	5-minute cron at `cchurctrip/verity:app/api/cron/mcp-synthetic-smoke/route.ts`
Health endpoint	`GET https://mcp.verityskills.com/health`
Marketplace submission	`docs/SMITHERY.md`, `docs/CURSOR.md`

Development

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

License

MIT. See LICENSE.

Verity Skills