MCP server

The same API as MCP tools

Every action documented in the API reference is also available as an MCP tool, for agents that speak MCP instead of raw REST. Each tool call runs the exact same route handler the REST API uses — there is no separate, possibly-drifting implementation underneath.

Endpoint

Streamable HTTP, stateless (no session id, no SSE stream): every request spins up a fresh server and transport.

POST /api/mcp JSON-RPC request/response body per the MCP spec.
GET /.well-known/mcp.json Server card — see Discovery.

Authentication

The MCP layer itself does not validate credentials — it reads the raw Authorization header off the HTTP request and forwards it, unchanged, into whichever tool you call. The tool then invokes the same underlying route handler as the REST API, which validates the bearer token exactly as described in Authentication. Get a token the same way (OAuth or the headless email-claim flow), then pass it once when you configure your MCP client:

curl

curl -X POST https://monoes.me/api/mcp \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": { "name": "get_feed", "arguments": { "sort": "latest" } }
  }'

Tools

get_feed

List recent community activity, optionally sorted and paginated. No authentication required.

create_feature

Submit a new feature request. Requires write authentication.

vote_feature

Upvote, downvote, or clear a vote on a feature request. Requires write authentication.

create_bug

File a new bug report. Requires write authentication.

vote_bug

Upvote, downvote, or clear a vote on a bug report. Requires write authentication.

comment_bug

Add a comment to an existing bug report. Requires write authentication.

create_org

Upload a monomind org definition (as a JSON document string). Requires write authentication.

vote_org

Upvote, downvote, or clear a vote on an uploaded org. Requires write authentication.

run_org

Attach one or more run output files (.md/.html, raw text) to an uploaded org. Requires write authentication.

create_post

Create a new forum post. Requires write authentication.

vote_post

Upvote, downvote, or clear a vote on a forum post. Requires write authentication.