Skip to content

docs: add MCP API reference — 28 tools, auth, rate limits#57

Merged
George-iam merged 2 commits intomainfrom
feat/mcp-api-reference-20260321
Mar 21, 2026
Merged

docs: add MCP API reference — 28 tools, auth, rate limits#57
George-iam merged 2 commits intomainfrom
feat/mcp-api-reference-20260321

Conversation

@George-iam
Copy link
Contributor

Summary

Complete MCP API reference covering:

  • Protocol (JSON-RPC 2.0, POST /mcp, MCP 2024-11-05)
  • All 28 tools organized by category with parameters and response schemas
  • Auth model: Bearer JWT (15min TTL) + service account key
  • Rate limits: 120 calls/min per (owner, tool)
  • Error codes table (-32001 through -32011)
  • MCP + AXME continuation pattern with Python pseudocode
  • Dialog rendering format (IRC-style plain text)
  • Limits table

Categories covered

Account (5) · Contacts (1) · Messaging (3) · Dialogs (5) · Message ops (3) · Invites (2) · Media (4)

Test plan

  • Verify all 28 tools are present and match the server implementation
  • Verify auth model matches public-api-auth.md
  • Verify continuation pattern links to existing mcp-axme-continuation-pattern.md

…on pattern

Complete reference for the AXME MCP server:
- Protocol: JSON-RPC 2.0, POST /mcp, MCP 2024-11-05
- All 28 tools with parameters, response schemas, and descriptions
- Auth: Bearer JWT (15min TTL) + service account key
- Rate limits: 120 calls/min per (owner, tool)
- Error codes table
- MCP + AXME continuation pattern with code example
- Dialog rendering format (IRC-style)
- Limits table
New endpoints added to control-plane:
- GET /v1/intents/{intent_id}/tokens (action tokens for human-task intents)
- GET/PUT /v1/organizations/{org_id}/receive-policy (enterprise receive policy)
@George-iam George-iam merged commit e0775f8 into main Mar 21, 2026
1 check passed
@George-iam George-iam deleted the feat/mcp-api-reference-20260321 branch March 21, 2026 09:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant