Mcp

1 operation. Every schema and example on this page is generated from the platform contract.

POST/api/v1/mcp

The Membber MCP server (Streamable HTTP, JSON-RPC 2.0): four read-only local discovery tools.

The Membber MCP server: Model Context Protocol over Streamable HTTP, one JSON-RPC 2.0 message per POST, answered as application/json. It needs no sign-in and exposes four read-only tools, each one a v1 operation: search_local_offerings (searchLocalOfferings), get_offering (getLocalOffering), get_live_availability (getLocalOfferingAvailability) and get_business (getLocalBusiness). Protocol versions 2026-07-28, 2025-11-25, 2025-06-18 and 2025-03-26.

auth public:readop mcpMessageidempotent retry rate limited errors

Request body

jsonrpcstringoptional

Always '2.0'.

idanyoptional

Present on a request, absent on a notification.

methodstringoptional

initialize, notifications/initialized, ping, server/discover, tools/list or tools/call.

paramsobjectoptional

curl -X POST "https://www.membber.com/api/v1/mcp" \
  -H "Authorization: Bearer $MEMBBER_TOKEN" \
  -H "Idempotency-Key: 1f0e2d3c-4b5a-4678-9abc-def012345678" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "<jsonrpc>",
    "id": "00000d1b-0000-4000-8000-d0c500000000",
    "method": "<method>",
    "params": {}
  }'

import { createMembberClient } from "@membber/sdk-ts";

const membber = createMembberClient({
  getAccessToken: () => process.env.MEMBBER_TOKEN,
});

const { data, error } = await membber.raw.POST("/api/v1/mcp", {
  body: {
    jsonrpc: "<jsonrpc>",
    id: "00000d1b-0000-4000-8000-d0c500000000",
    method: "<method>",
    params: {}
  },
  headers: { "Idempotency-Key": crypto.randomUUID() },
});

if (error) {
  // Typed error envelope: { error: { code, message, requestId } }
  throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);

import MembberSwift

let client = MembberClient(
    serverURL: MembberClient.productionServerURL,
    tokenProvider: { session.accessToken }
)

let response = try await client.api.mcpMessage(
    body: .json(.init(
        jsonrpc: "<jsonrpc>",
        id: "00000d1b-0000-4000-8000-d0c500000000",
        method: "<method>",
        params: .init()
    ))
).ok.body.json

print(response)

Response, 200

{
  "jsonrpc": "<jsonrpc>",
  "id": "00000d1b-0000-4000-8000-d0c500000000",
  "result": {},
  "error": {
    "code": -9007199254740991,
    "message": "Added at the front desk",
    "data": "<data>"
  }
}