docsMCP ServerQuickstart

MCP Quickstart

After installing the Ontyx MCP server and restarting your MCP client, Ontyx tools are available to your agent automatically. No additional configuration is required beyond the API key you placed in the server config.

Your first query

Open a conversation in your MCP client and ask a demographic question directly. The agent routes the request to Ontyx without any special syntax on your part.

> What's the population of zip code 94110?

The agent picks get_population, calls it with { "zip": "94110" }, and Ontyx returns:

{
  "ok": true,
  "zip": "94110",
  "city": "San Francisco",
  "state": "CA",
  "population": 73826,
  "quota": {
    "used": 12,
    "limit": 1000,
    "percent": 1,
    "state": "ok",
    "period": "2026-05"
  }
}

The quota envelope rides along with every successful call so the agent can warn you well before you run out.

What happens under the hood

  1. Your MCP client sees the Ontyx tool list and selects the appropriate tool from your prompt.
  2. The tool call is sent to the Ontyx MCP server with your API key in the Authorization header.
  3. The server authenticates the key, checks your rate limit and monthly credit allotment, then resolves the request from the demographic fixture (zip → city/state/population/income).
  4. Structured results return to the agent, which can reason over them, format them for display, or chain them into subsequent tool calls.

The entire round-trip is handled by the MCP protocol — no manual API calls or JSON parsing required on your side.

Credits

Usage is metered in credits. Each tool call currently costs one credit, and your monthly allotment depends on your plan — see Pricing for the current tiers, or the credit costs table for per-call details. You can monitor consumption from the Dashboard.

  • Free tier — credits reset at the start of every month, forever. When a month’s credits are used up, calls return a structured QUOTA_EXCEEDED result until the reset (or an upgrade).
  • Standard — soft overage: calls near or past your allotment still succeed, and the quota envelope in each response carries a warning once you cross 80%. You will never be cut off mid-session.

Next steps

Connect your assistantAvailable Tools