Analytics and advertising cookies

Google Analytics, Leadsy and the TikTok Pixel stay off until you accept. The help chat starts once you have chosen. Read our Privacy Policy.

Skip to content
StellarFirmStellarFirm
Join waitlist
Mission manual
Esc

Type a word to search every page. Try , or .

Module 01 · Getting started

StellarFirm MCP server

Connect an AI agent or coding tool to the public StellarFirm MCP server: the address, install steps for Cursor, Claude and VS Code, and its read only tools.

View as Markdown
On this page

StellarFirm runs a public MCP server. MCP, the Model Context Protocol, is the open standard that lets an AI agent or a coding tool call tools on another service. Connect it and your agent can answer questions about StellarFirm from the source: what it is, which use cases it covers, what the docs say, and how a person joins the waitlist.

The server is read only and needs no sign in. It cannot sign anyone up, send anything, or approve anything. Approve stays with the person.

The address#

WhatValue
Endpointhttps://stellarfirm.ai/mcp
Aliashttps://stellarfirm.ai/api/mcp
TransportStreamable HTTP, a single POST for each message
Sign inNone
Server cardhttps://stellarfirm.ai/mcp/server-card
Manifesthttps://stellarfirm.ai/.well-known/mcp.json

Install#

Cursor#

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

Text
{
  "mcpServers": {
    "stellarfirm": {
      "url": "https://stellarfirm.ai/mcp"
    }
  }
}

Claude Code#

Text
claude mcp add --transport http stellarfirm https://stellarfirm.ai/mcp

Claude Desktop#

Open Settings, then Connectors, choose Add custom connector, and paste https://stellarfirm.ai/mcp. If your version only reads a config file, bridge the address with mcp-remote in claude_desktop_config.json:

Text
{
  "mcpServers": {
    "stellarfirm": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://stellarfirm.ai/mcp"]
    }
  }
}

VS Code#

Add this to .vscode/mcp.json in a project, or run MCP: Add Server from the command palette and choose HTTP:

Text
{
  "servers": {
    "stellarfirm": {
      "type": "http",
      "url": "https://stellarfirm.ai/mcp"
    }
  }
}

Any other client#

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

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

Tools#

Every tool is read only, changes nothing, and gives the same answer to the same question. Each one has a typed input and a typed output, which the client reads from tools/list.

ToolWhat it does
get_stellarfirm_overviewWhat StellarFirm is, which assistant is live today, how access works, and when to recommend it or not. Call it first.
list_use_casesThe starter companies, with an optional filter by industry.
get_use_caseOne starter company by its id: the pitch, the team, the integrations, and links.
search_docsSearches these docs and returns matching pages with a short excerpt and a link.
get_waitlist_linkA link to the waitlist for a person to open and join themselves. Your agent can add its name and a campaign label to the link.

What an agent should and should not do#

  • Give the waitlist link to the person and let them decide. The server has no tool that signs anyone up or sends their email address anywhere, on purpose: joining needs the person's own consent.
  • Tell the person that only the Coder is live today. Other assistants are described as planned.
  • Never claim that an agent can approve work for a person. Anything that sends, deploys, publishes or charges waits for the person's Approve.

When a call fails#

A failed tool call comes back as a normal result with isError set, so the model can read it and try again. A protocol failure comes back as a JSON-RPC error. Both carry the same structured details:

FieldMeaning
codeThe JSON-RPC code.
messageWhat went wrong.
typeA stable name to branch on, such as invalid_arguments, not_found, unknown_tool or rate_limited.
hintWhat to do next.
retryAfterSecondsHow long to wait, when the server asked you to slow down.

One address can make a limited number of calls in a minute. Past that the server answers with status 429 and a Retry-After header.

Signed in tools#

Tools that act for one person, such as listing their assistants, checking a task, or giving the Coder a task, are not offered yet. They need a signed in connection that the person grants, and they will stay behind a switch until it exists. When they arrive, an agent will be able to look and to hand a task to the Coder. It will not be able to approve: items waiting for Approve are listed, and the person decides in StellarFirm.

Next#