Skip to content

The MCP server for every kind of data.

An MCP server gives AI agents tools they can call. Add PrimaryAPI’s to Claude Code, Cursor, Codex or VS Code and sign in, and your agent can search the catalog, read an API’s schema and price, and run it.

Create an accountRead the MCP docs

Add the URL and sign in, with no key to copy. An API key works too. You only pay when data comes back.

Server URL

https://api.primaryapi.com/mcp
claude mcp add --transport http primaryapi \
  https://api.primaryapi.com/mcp

Run it in a terminal, then type /mcp in Claude Code to sign in.

What it is

What is an MCP server? A set of tools an agent can call.

MCP, the Model Context Protocol, is an open-source standard for connecting AI applications to external systems. Its docs compare it to a USB-C port for AI applications. Read on What is the Model Context Protocol? (modelcontextprotocol.io) (opens in a new tab)

Through MCP, AI applications such as Claude or ChatGPT reach data, tools such as search engines and calculators, and workflows such as specialised prompts. Read on What is the Model Context Protocol? (modelcontextprotocol.io) (opens in a new tab)

An MCP server is the program that offers those tools. Each tool has a name, a description and the arguments it takes, and the AI client decides when to call one and with what.

MCP defines two standard transports: stdio, where the client launches the server as a local subprocess, and Streamable HTTP, where each message is an HTTP POST to one endpoint. Read on MCP specification: transports (modelcontextprotocol.io) (opens in a new tab)

PrimaryAPI’s server is a remote one over Streamable HTTP: your client sends its requests to one URL, signed in to your workspace or with an API key in a header.

The tools

What your agent can do with PrimaryAPI’s server.

The same verbs as the REST API, the same prices and the same errors. Arguments are strict: an API’s own fields go inside input.

ToolWhat it doesAccess
search_apisFind APIs by keyword or use case.Any
list_apisBrowse APIs by category or platform, a page at a time.Any
get_apiRead one API’s input and output schema, examples, notes and price.Any
quote_apiCheck an input and see its price in credits without running it.Run or full
run_apiRun an API and get its result. This spends credits.Run or full
get_requestCheck on an earlier call, with its result once it is done.Any
read_resultRead a stored result again for free, trimmed if you like.Any
get_balanceSee the workspace’s credits and whether its keys are paused.View or full
report_bugReport wrong data or an error that looks like ours.Any
send_feedbackSend feedback, or ask for an API that is missing.Any

Every tool needs a sign-in or an API key. Access is the key’s level, or what you approved when you signed in.

How an agent uses it

Find it, read it, then run it.

  1. search_apis Search for what it needs, such as “google maps reviews”. Free.

  2. get_api Read the chosen API’s input schema before its first run: field names are exact.

  3. quote_api Optionally, check the price for this exact input. Free.

  4. run_api Run it, asking only for the fields and items it needs.

  5. get_request If the call is still running, check back later instead of running it again, which would start a second job.

What the agent sends
// 1. Find an API. Free.
{
  "name": "search_apis",
  "arguments": {
    "query": "reddit posts about a topic"
  }
}

// 2. Run it. This spends credits.
{
  "name": "run_api",
  "arguments": {
    "sku": "reddit.search",
    "input": {
      "query": "best mechanical keyboard",
      "limit": 10
    },
    "fields": [
      "title",
      "score",
      "permalink"
    ],
    "max_items": 5
  }
}

By platform

Platforms your agent can read.

One server and one sign-in reach every platform in the catalog. These pages show what an agent gets for each one.

Spending and safety

Agents spend only what you allow.

  • Sign in, no key to copy. Your client opens the browser, and you pick the workspace and approve. You can revoke it anytime in Connected apps.

  • Cap what it can spend. Set a spend limit when you approve the sign-in, or give each agent its own key with run access and a limit, so a runaway loop stops at a number you chose.

  • Keep keys out of prompts. Sign in, or set the key in the client’s configuration. The server never asks a model for its key and never returns one.

  • Treat results as data. Posts, comments and pages are written by other people. Don’t let what an API returns give your agent instructions.

  • Restricted APIs stay closed. APIs that return personal contact details need an approved account, and an agent’s trial key can never call them.

Questions

MCP server, answered.

Something else? Write to [email protected]

What is an MCP server?

A program that offers tools to AI applications over the Model Context Protocol, an open standard. An agent connected to one can see its tools, read what each one needs and call them while it works.

What does PrimaryAPI’s MCP server do?

It puts the PrimaryAPI catalog in front of your agent. The agent can search for an API, read its schema and price, run it on your credits and re-read results, across social platforms, maps, company filings and validation checks.

Which MCP clients does it work with?

Claude Code, Claude Desktop, Cursor, Codex and VS Code, with the set-up shown on this page, and any other client that connects to remote MCP servers over Streamable HTTP, by signing in or with an API key in a header.

Is the MCP server free?

Connecting is free: you sign in with your account, and searching and reading about APIs costs nothing. Running an API spends credits at that API’s price, and you only pay when data comes back.

Do I need an API key for the MCP server?

No. Add the server URL to your client and sign in: you pick a workspace and approve in the browser. A key still works for clients that can’t sign in and for agents working on their own. Set it in the client’s configuration, never in a prompt.

What is the difference between a local and a remote MCP server?

A local server runs on your computer: the client starts it and talks to it over standard input and output. A remote server runs elsewhere and the client reaches it over HTTP. PrimaryAPI’s server is remote.

Is signing in different from using a key?

Only in how you connect. Calls are charged to the same workspace credits, with the same access levels and rate limits as a key, and you can set a spend limit when you approve.

Can an AI agent sign itself up?

Yes. An agent can mint a capped trial key on its own, use it right away and hand you a claim link when it needs more. You approve a spend limit, and the agent keeps the same key.

Hand your agent every kind of data.

Add one URL to your MCP client and sign in. Prefer a key? Make one with a spend limit in the dashboard.