Developer docs

Velocity developer documentation

Everything you need to build on Velocity: the MCP server for market and security intelligence, the commercial REST API, authentication, tiers and quotas, and a two-minute quickstart. Start free.

Get an API keyREST API reference
Quickstart

From zero to first call in four steps

1

Create an account

Sign up at /register. The Free tier lets you view all trends and use most MCP tools right away.
2

Mint an API key

Open the Agent Hub, add a label, and generate a vel_* key. Copy it immediately — it is shown only once.
3

Connect or call

Add the MCP server to your agent, or call the REST API directly with Authorization: Bearer vel_….
4

Watch & alert

Build a watchlist or a tech-stack watch, then receive threshold and CVE alerts via email, push, webhook, SSE, or an MCP tool call.
quickstart.shbash
# 1) Get active security trends (REST, Bearer key)
curl -H "Authorization: Bearer vel_your_api_key" \
  "https://velocity.andiamo.tech/api/v1/trends?category=security&minScore=50&limit=10"

# 2) Connect an agent via MCP (Claude Code)
claude mcp add --transport http \
  --header "X-MCP-Key: vel_your_api_key" \
  velocity https://velocity.andiamo.tech/api/agents/mcp
Reference

Pick your integration surface

Deep references for the MCP server and REST API, plus the in-app surfaces where you get a key and see the data.

Authentication

One key type, hashed at rest

Every programmatic surface authenticates with a vel_* API key minted from the Agent Hub. The key is displayed exactly once and stored only as a SHA-256 hash, so it can never be recovered or logged — only revoked. Each call is authorized as the user who issued the key.

How to pass the key

  • REST API (/api/v1/*): Authorization: Bearer vel_…
  • MCP — Claude Code / OpenClaw: X-MCP-Key: vel_…
  • MCP — Codex / OpenAI Responses / ChatGPT: Authorization: Bearer vel_…

Tiers & quotas

Velocity runs from Free through Starter, Pro, and Unlimited, with team plans (Startup and Enterprise) on top. Anyone can view all trends; the REST API requires Starter or above, and a few MCP tools require Pro. Daily call quotas and data freshness both scale with tier — see the REST API reference for the exact quota table and the pricing page for plan details and commercial-use terms.

FAQ

Common developer questions

  • Where do I get an API key?

    Sign in to Velocity and open the Agent Hub at /agents. In the API Keys tab, add a label and generate a vel_* key. The plaintext is shown only once; Velocity stores a SHA-256 hash. Revoking a key from that tab takes effect immediately.

  • What is the difference between the MCP server and the REST API?

    The MCP server (/api/agents/mcp) exposes 14 read-only tools over JSON-RPC for AI agents — Claude Code, OpenClaw, Codex, OpenAI Responses, and ChatGPT. The REST API (/api/v1/*) is plain HTTP — GET /api/v1/trends and /api/v1/pulse — for backends and scripts. Both authenticate with the same vel_* keys.

  • Which plan do I need for the API?

    The commercial REST API requires a Starter plan or above; Free-tier keys receive a 403. Most MCP tools work on Free, with velocity_momentum_check, velocity_correlation_lookup, and security_subscribe_stack_hits requiring Pro or higher. Daily call quotas scale with tier.

  • Is there rate limiting?

    Yes. The REST API enforces a per-tier daily quota and returns X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers; an exhausted quota returns 429 with a Retry-After header. MCP tools/call is rate-limited per user by tier. See the API reference for the full table.

  • How do I read trend data programmatically?

    Every public trend page also exposes a stable AgentDossierSummary JSON block (v1.0) that agents can read directly. For bulk access, poll GET /api/v1/trends (filter by category and minScore) or GET /api/v1/pulse for a lightweight snapshot.

Build on live signal intelligence

Create a free account, generate a key, and make your first call in minutes.

Create free accountConnect via MCP