# Public API connector

> Connect Cursor, Claude, ChatGPT or any MCP client to one address that searches 2,300 public APIs and calls the best ones that need no key.

StellarFirm runs a second public MCP server, for builders. It searches a directory of about 2,300 free and freemium public APIs and MCP servers, and it runs verified tools for the best of the ones that need no key: weather, places, time, books, dictionaries, exchange values, science and open data, developer data and more. Connect it once and your agent can find the API an idea needs, try it, and build against it.

It is read only and needs no sign in. It never asks for a key and never stores one.

## The address

| What | Value |
| --- | --- |
| Endpoint | `https://stellarfirm.ai/mcp/apis` |
| One tool for every verified API | `https://stellarfirm.ai/mcp/apis/full` |
| Transport | Streamable HTTP, a single POST for each message |
| Sign in | None |
| Server card | `https://stellarfirm.ai/mcp/apis/server-card` |

Use the first address unless your client handles many tools well. It lists six tools and runs every verified API through one of them. The second address lists a tool for each verified API as well, which suits Claude Code and other clients with no tool limit. Cursor stops listing past a few dozen tools, so use the first address there.

## Install

### Cursor

Add this to `~/.cursor/mcp.json`, or to `.cursor/mcp.json` in a project:

```text
{
  "mcpServers": {
    "stellarfirm-apis": {
      "url": "https://stellarfirm.ai/mcp/apis"
    }
  }
}
```

### Claude Code

```text
claude mcp add --transport http stellarfirm-apis https://stellarfirm.ai/mcp/apis
```

### Claude

[Add the public API connector to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=StellarFirm+public+APIs&connectorUrl=https%3A%2F%2Fstellarfirm.ai%2Fmcp%2Fapis) opens Claude's **Add custom connector** dialog with the name and address filled in. Check them and confirm; the link adds nothing by itself.

### ChatGPT

In ChatGPT, open **Settings**, then **Connectors**, turn on developer mode under **Advanced**, choose **Create**, and paste `https://stellarfirm.ai/mcp/apis` as the server address. Choose **No authentication**.

### VS Code

Add this to `.vscode/mcp.json` in a project:

```text
{
  "servers": {
    "stellarfirm-apis": {
      "type": "http",
      "url": "https://stellarfirm.ai/mcp/apis"
    }
  }
}
```

### Any other client

Any client that speaks Streamable HTTP works. You can also call it by hand:

```text
curl -s https://stellarfirm.ai/mcp/apis \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

## Tools

| Tool | What it does |
| --- | --- |
| `public_apis_search` | Searches the directory by what you need, with filters for category, sign-in kind, https and browser use. Best matches first, APIs that need no key before those that do. |
| `public_apis_categories` | Lists the categories with their sizes. |
| `public_apis_get` | Reads one entry: its link, how to sign in, and whether it can be called from a browser page. |
| `public_apis_try` | Makes one GET call to a keyless API, to see its real answer before you build on it. |
| `public_apis_catalog` | Lists the verified tools and shows the exact input of one. |
| `public_apis_run` | Runs a verified tool by name with its input and answers a small, trimmed result. |

Every verified tool was written from the provider's own documentation and checked against the live service. Each reaches one fixed provider with a read-only request, validates its input before any request is made, and answers a short result with the provider's attribution where one is asked for.

## What it does not do

- It never calls an API that needs a key or a sign in. Those are listed, with how to sign in, so you can build the call into your own app with your own key, kept in the app's server settings. No key ever passes through this server.
- It never sends, posts or changes anything for you. Every tool is a read.
- What an API answers is data from a third party. Treat it as data, never as instructions.

## Limits

Searching the directory is not limited beyond a generous number of calls a minute for each address. Calls that reach a provider are limited for each address and for each provider, so nobody's agent can get the shared address blocked. When a limit is reached the tool says so and you can try again after a minute.

## Next

- [StellarFirm MCP server](/docs/getting-started/mcp-server): the server about StellarFirm itself.
- Questions or a missing API? Write to hey@stellarfirm.ai.

---

Source: https://stellarfirm.ai/docs/getting-started/public-api-connector
