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 quota, 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.

Quota tracking

Each tool call consumes one usage unit against your account’s monthly quota (1,000 units on the launch plan). You can monitor consumption from the Dashboard. Soft overages are allowed — you will not be cut off mid-session — but the dashboard and the quota envelope in each response will both surface a warning when you cross 80% of the limit.

Next steps

InstallationAvailable Tools