Get started

MCP tools72

HTTP API416

Identity, sign-in and browser sessions
Accounts, workspaces and personal context
Members and invitations
Launch flags and admission
Agent clients, machine keys and MCP
Suite API credentials
Work board and items
Attention and approvals
Agent sessions and review
Ideas
Memory, sources and Recall
Context links
Projects and Editor
Home dashboard
Calendar
Personal Life
Files and jobs
Briefings
Design and Design evals
Security
Settings and preferences
Data lifecycle: export and deletion
Marketing, docs, legal and contact
Billing and subscriptions
Credits and wallet
Usage metering and spend controls
Search
Presence, page analytics and Updates
Skills
Other operations

design.answerClarification

TOOLtools/call

Answer only an explicitly delegated factual question; human preference questions cannot be answered by agents.

Scopes

read:designanswer:design_clarifications

Inputs

idempotencyKeystringRequired
clarificationIdstringRequired
expectedVersionintegerRequired
disposition"answer" | "defer" | "localOnly" | "dismiss" | "reopen"Required
answerstring
revisitAtinteger

Returns

The Design operation's result. A call returns content[0].text with the JSON result and structuredContent.result with the same value.

Listed when

The key has Design access and the tool's scope.

Request

{
  "jsonrpc": "2.0",
  "id": "example_design_answerClarification",
  "method": "tools/call",
  "params": {
    "name": "design.answerClarification",
    "arguments": {
      "idempotencyKey": "retry-1",
      "clarificationId": "<clarificationId>",
      "expectedVersion": 0,
      "disposition": "answer"
    }
  }
}

Endpoint

POST https://www.specifywork.com/api/mcp

Authorization: Bearer <agent key>, a key that starts with sw_agent.