annsa
Log inStart free

Developers

Annsa for developers

The MCP server, the REST API and every machine-readable surface, in one place. Nothing to install.

Start freeRead the API docs

Connect over MCP

Annsa MCP is a remote server. There is no package to install, no local process and no token file to manage.

Claude Code

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

Cursor

Settings → MCP → Add server → https://app.annsa.ai/mcp

The first run opens your browser for OAuth on Annsa's consent screen. To re-authenticate, use the client — in Claude Code that is /mcp → annsa → Authenticate.

6 tools, one connection

What the agent gets once it is connected.

annsa.priorities
The ranked list, with the reasoning attached
annsa.spec
A full spec, grounded in the repo
annsa.act
Act on a priority — state, ownership, outcome
annsa.ask
Ask a question of the feedback itself
annsa.surveys
Read survey results and response detail
annsa.help
What this server can do, for the agent

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

Asked + answered.

Q1
Is there an npm package?
There is an annsa package on npm, but it only prints the connect instructions — the CLI is not out yet. Annsa MCP is a remote server, so there is nothing to install to start using it today.
Q2
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.
Q3
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.
Q4
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.
annsa

Feedback in. Specs out.

500 extra pieces of feedback in your first month.

Start freeRead the API docs