---
title: "The MCP server (Streamable HTTP, stateless)"
method: POST
path: "/mcp"
tags: ["OAuth / MCP"]
---

# The MCP server (Streamable HTTP, stateless)

`POST /mcp`

## Request

- Base URL: `https://whatareyoudo.ing/api/v1`
- URL: `https://whatareyoudo.ing/api/v1/mcp`
- Auth: HTTP bearer

JSON-RPC 2.0 per the Model Context Protocol. Tools: list_diaries, list_entries, read_entry, write_entry, list_wiki_pages, read_wiki_page, write_wiki_page. Without a valid bearer it answers 401 with `WWW-Authenticate: Bearer resource_metadata=".../.well-known/oauth-protected-resource/api/v1/mcp"`.

## Request body

- McpRequest
  - `jsonrpc` '2.0', required
  - `method` string, required
  - `id` union
    - string
    - number

## Response `200`

JSON-RPC response

## Other responses

- `202`: A notification was accepted
- `401`: No or invalid bearer; see WWW-Authenticate

---

[API](https://skmtc.dev/whatareyoudo/apis/whatcha-api.md) · [All operations](https://skmtc.dev/whatareyoudo/apis/whatcha-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whatareyoudo/apis/whatcha-api/revisions/48dd8a54abea?raw)