SpecifyDocs
Sign in

API reference

Every MCP tool and HTTP operation Specify runs, with the scopes, inputs and an example for each. The pages are generated from the registries the server reads.

Connect an agent

Create an agent key in Agents, then add the server to your MCP client. Call verify_access first: it returns the key's workspace, scopes and expiry.

MCP client config

{
  "mcpServers": {
    "specify": {
      "url": "https://www.specifywork.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${SPECIFY_AGENT_KEY}"
      }
    }
  }
}

Credentials

Agent key

Agents call the 72 MCP tools. Over HTTP a key reaches only the 4 briefing queue operations.

Signed-in session

The web app's HTTP API: 401 operations act as the person and the account they choose.

Device signature

The specify CLI signs 7 Skills operations with a key its owner enrolled.

MCP tools

72 tools over JSON-RPC at POST https://www.specifywork.com/api/mcp, MCP 2025-06-18. A client lists only the tools its key may call.

Access and context, 2
Access and context2The key has agent access.
Work, 8
Work8The key has agent access.
Ideas, 4
Ideas4The key has agent access.
Memory, 8
Memory8The key has agent access.
Context links, 3
Context links3The key has agent access.
Life, 6
Life6The key has agent access.
Reviews and approvals, 4
Reviews and approvals4The key has agent access.
Sessions, 5
Sessions5The key has agent access.
Tasks, 7
Tasks7The key has read:projects.
Projects and documents, 2
Projects and documents2The key has read:projects.
Files, 8
Files8The key holds the tool's Files scope.
Briefings, 4
Briefings4The key is a briefing queue producer with the tool's scope.
Design, 11
Design11The key has Design access and the tool's scope.

HTTP API

416 operations under /v1, grouped by what they do for the person using them.

Identity, sign-in and browser sessions, 4
Identity, sign-in and browser sessions4People sign in with Google or a six-digit email code, verify their account, and see and revoke their signed-in browser sessions from Settings.
Accounts, workspaces and personal context, 11
Accounts, workspaces and personal context11Every person gets a personal account with its own Work root.
Members and invitations, 8
Members and invitations88 operations.
Launch flags and admission, 1
Launch flags and admission1Launch flags decide which products an account can open.
Agent clients, machine keys and MCP, 4
Agent clients, machine keys and MCP4People create, rotate and revoke agent keys, connect an agent over MCP, and confirm that the agent reached their workspace.
Suite API credentials, 4
Suite API credentials4Account admins will create, rotate and revoke credentials for the suite API.
Work board and items, 15
Work board and items15People open My tasks at /work: the open project tasks assigned to them across every project, in one table.
Attention and approvals, 13
Attention and approvals13Attention collects what needs a person: agent approval requests and questions, memory proposals to review, their own tasks that are due or waiting for review, and notifications.
Agent sessions and review, 8
Agent sessions and review8People follow what their agents are doing: open sessions, progress events, and the finished sessions that need a person to check them.
Ideas, 6
Ideas6People and agents capture ideas, search them, and promote one into Work when it is ready.
Memory, sources and Recall, 15
Memory, sources and Recall15Durable memory that people and agents share: agents propose memories, people accept or correct them, and Recall finds them again with cited results.
Context links, 8
Context links8Links between Work items, ideas, memories and other records, so people see related context next to what they are working on.
Projects and Editor, 58
Projects and Editor58People plan work as projects with tasks, sprints, a board, a backlog, a timeline and a dashboard, and write shared documents in one editor with history and media.
Home dashboard, 12
Home dashboard12Home answers "what needs me today" on one screen.
Calendar, 11
Calendar11A calendar for personal and project events that agents can manage, with full history and rollback.
Personal Life, 17
Personal Life17Private trackers for hydration, nutrition, fitness, sleep, pets, check-ins and custom measures.
Files and jobs, 23
Files and jobs23People and agents upload files, link them to tasks, memories and briefings, preview them, and run processing jobs on them.
Briefings, 67
Briefings67Written and audio briefings from a person's work and memory: schedules, a listening queue, one player that keeps playing across the suite, a private feed and verified email delivery.
Design and Design evals, 36
Design and Design evals36An internal tool for design rules and components that agents synthesize, review and promote, with evaluation runs to check them.
Security, 19
Security19People see the devices that run their agents, their security posture and the events those devices report.
Settings and preferences, 8
Settings and preferences8Settings is a section of the workspace: Profile, Appearance, Notifications, Sessions and Account, the Keybindings and Table actions layout sections, and Agent keys, with search across every row.
Data lifecycle: export and deletion, 12
Data lifecycle: export and deletion12Settings, Account exports a person's data, closes an organization they own and deletes their account.
Marketing, docs, legal and contact, 1
Marketing, docs, legal and contact1The public site: product pages, pricing, developer docs, legal pages and a contact form.
Billing and subscriptions, 6
Billing and subscriptions6People choose a plan, pay, manage their subscription and see what their plan includes.
Credits and wallet, 2
Credits and wallet2AI credits pay for generation such as briefings and processing jobs.
Usage metering and spend controls, 1
Usage metering and spend controls1Monthly meters for agent operations, semantic searches and active memories, plus provider spend limits that stop costly features before they overspend.
Search, 1
Search1One query in the command palette finds tasks, projects, memories, files and people, grouped by type with the best matches first.
Presence, page analytics and Updates, 1
Presence, page analytics and Updates1One operation.
Skills, 19
Skills19People keep their agent skills and Rules in Specify and the specify CLI syncs them to every agent provider on each of their machines.
Other operations, 25
Other operations2525 operations.

Errors

Over HTTP, 400, 401, 403, 404, 409, 429 and 503 return {"error": {"code", "message", "correlationId"}}. Over MCP, a refused call returns isError: true and the error code in content[0].text.

Error

JSON
{
  "error": {
    "code": "<code>",
    "message": "<message>",
    "correlationId": "<correlationId>"
  }
}