Skip to content

Developers

Annsa for developers

Connect your agents to Annsa’s shared plan through MCP, or bring in feedback through the REST API. Nothing to install. Find the setup guides and machine-readable references here.

Connect over MCP

A remote server. Nothing to install.

claude mcp add --transport http annsa https://app.annsa.ai/mcp

8 tools, one connection

What the agent gets once it is connected.

annsa.priorities
See what to work on next, ranked, with the evidence behind it.
annsa.spec
Read the plan for one priority: what to build, why, and Done When.
annsa.ask
Ask about your customers, your work or Annsa itself.
annsa.work
Do the work on a priority, and settle routine asks with undo.
annsa.file
Add what a customer said, what an agent found, or a new idea.
annsa.decide
Record a decision: your answer, a spec edit, or a rule.
annsa.board
Arrange the board. A merge retires numbers for good.
annsa.share
Tell the customers who asked that it shipped. Emails can't be unsent.

Machine-readable surfaces

Every page on annsa.ai also has a markdown representation. Request any URL with an Accept header of text/markdown and you get the page as markdown rather than HTML.

/openapi.json
OpenAPI 3.1 spec for the REST API. CORS-open.
/.well-known/mcp.json
MCP discovery document.
/.well-known/mcp/server-card.json
Server card (SEP-2127): name, icon, description.
/.well-known/ai-catalog.json
ARD catalog, spec 1.0.
/auth.md
How an agent authenticates, including what does not exist.
/llms.txt
The site, summarized for a model.
/llms-full.txt
The full reference, including every changelog entry.

The REST API is documented at /docs/api, and how an agent gets its own credential at /docs/agent-access.

Clients with a connect guide

Any MCP client can connect. These 8 have a page of their own.

Claude CodeCursorCodexChatGPTWindsurfFigma MakeLovableBolt

Questions people ask.

Do I need to install anything?
Remote MCP at https://app.annsa.ai/mcp is the way to connect; there is nothing to install.
How does an agent authenticate?
OAuth 2.1 with PKCE S256. Access tokens last 30 days and refresh tokens 90. The first run opens a browser on Annsa's consent screen. Full detail, including what does not exist, is at /auth.md.
Can an agent have its own credential rather than a seat?
Yes. An agent can be minted a credential of its own, so every action it takes is signed with its name and traceable back to it. See /docs/agent-access.
Is the OpenAPI spec callable from a browser?
Yes. /openapi.json is CORS-open and linked from every page as rel=service-desc, so a tool can find it without being told where to look.

The source of direction for agent teams.

Begin with one agent and the work that matters next.