---
title: "Call the remote Spoonjoy MCP endpoint"
method: POST
path: "/mcp"
tags: ["MCP"]
---

# Call the remote Spoonjoy MCP endpoint

`POST /mcp`

## Request

- Base URL: `https://spoonjoy.app`
- URL: `https://spoonjoy.app/mcp`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://spoonjoy.app/oauth/authorize`, token URL `https://spoonjoy.app/oauth/token`, scopes: `kitchen:read`, `kitchen:write`)

## Request body

- McpJsonRpcRequest
  - `jsonrpc` '2.0', required
  - `id` union, required
    - string
    - number
  - `method` string, required
  - `params` object

## Response `200`

JSON-RPC response

- McpJsonRpcResponse
  - `jsonrpc` '2.0', required
  - `id` union, required
    - string
    - number
  - `result` object
  - `error` object

## Other responses

- `401`: OAuth bearer challenge. See WWW-Authenticate and .well-known/oauth-protected-resource/mcp.
- `429`: Rate limited. This is the generic Spoonjoy rate-limit shape, not a standard OAuth error.

---

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