# GridRouter docs (/docs)



GridRouter puts email finders, enrichment, phone, signals and the rest of the go-to-market data
stack behind one REST API, one API key and one MCP server. Every provider endpoint is described in
the same catalog: the same input shape, the same normalized output fields, a price and a quality
score measured on real calls.

<Callout title="Launch: everything runs on your own vendor keys">
  Every workspace is on the Free plan. Calls run on the vendor keys you add (BYOK), GridRouter
  never charges for them, and nothing is sold yet. Paid plans and managed vendor accounts are
  coming soon.
</Callout>

## Start here [#start-here]

<Cards>
  <Card title="Quickstart" href="/docs/getting-started" description="Sign up, add a vendor key, create an API key and make a first call." />

  <Card title="Connect MCP" href="/docs/getting-started/connect-mcp" description="Connect a client that supports MCP 2026-07-28 stateless Streamable HTTP." />

  <Card title="API reference" href="/docs/api" description="Every route, generated from the gateway's OpenAPI document." />

  <Card title="Errors" href="/docs/errors" description="One error envelope, stable codes and what to do about each." />
</Cards>

## How it fits together [#how-it-fits-together]

* **[Capabilities and endpoints](/docs/concepts/capabilities-and-endpoints).** An endpoint is one
  provider's API call (`hunter/email.find`). A capability is the task it performs
  (`people.email.find`), shared by every provider that can do it.
* **[`/v1/call` and `/v1/run`](/docs/concepts/routing).** `call` runs exactly the endpoint you
  name. `run` takes a capability and tries providers in order until one finds the answer.
* **[Waterfalls](/docs/concepts/waterfalls)** save a provider order, stop rules and a per-field merge
  as your own endpoint.
* **[Execution options](/docs/concepts/execution-options)** control timeouts, cost caps, cache and
  logging per request, key, preset or workspace.
* **[Logs](/docs/concepts/logs-and-drains)** record every call, stream live and say whether the
  provider [billed it correctly](/docs/concepts/billing-verification).

## For agents [#for-agents]

Every page is also Markdown: add `.md` to its URL, or send `Accept: text/markdown`. The index is at
[`/llms.txt`](/llms.txt) and every written page in one file at [`/llms-full.txt`](/llms-full.txt).
The OpenAPI document is at `https://api.gridrouter.io/openapi.json`.

