MCP endpoint (JSON-RPC)

/v1/mcp

Headers: send Accept: application/json, text/event-stream. The server is stateless by default; Mcp-Session-Id and MCP-Protocol-Version are optional and forwarded. Every tool, resource and protocol method is in the MCP Reference.

Authorization: send Authorization: Bearer $PLUNGE_API_KEY; X-API-Key: <ozk_ key> is accepted as an alternative.

Authorizations

Authorizationstringheaderrequired

Bearer token: Authorization: Bearer ozk_…. ozk_ platform API key (Authorization: Bearer ozk_…)

Body

application/json

JSON-RPC 2.0 message

Type: object

Response

JSON-RPC response (JSON, or SSE for streamed tool calls)

application/json
text/event-stream

Missing, invalid, expired or revoked ozk_ key.

Error code: unauthorizedfrom code

rate_limited — Retry-After header

application/json

errorobjectrequired

Show child attributes

codestringrequired

messagestringrequired

Stream events

Event	Description
`notifications/progress`	Progress of a long `tools/call`.
`notifications/message`	A log line from the server.
`result`	The final JSON-RPC response.

event: message
data: {"jsonrpc":"2.0","method":"notifications/progress","params":{"progressToken":1,"progress":1,"message":"Running…"}}

event: message
data: {"jsonrpc":"2.0","method":"notifications/message","params":{"level":"info","data":"…"}}

event: message
data: {"jsonrpc":"2.0","id":3,"result":{"content":[{"type":"text","text":"…"}]}}

import os import requests res = requests.post( 'https://mcp.plungeai.com/v1', headers={ 'Authorization': f"Bearer {os.environ['PLUNGE_API_KEY']}", 'Accept': 'application/json, text/event-stream', }, json={'jsonrpc': '2.0', 'id': 1, 'method': 'initialize', 'params': {'protocolVersion': '2025-11-25', 'capabilities': {}, 'clientInfo': {'name': 'docs-sample', 'version': '1.0.0'}}}, ) print(res.status_code, res.text)

import os import requests res = requests.post( 'https://mcp.plungeai.com/v1', headers={ 'Authorization': f"Bearer {os.environ['PLUNGE_API_KEY']}", 'Accept': 'application/json, text/event-stream', }, json={'jsonrpc': '2.0', 'id': 2, 'method': 'tools/list'}, ) print(res.status_code, res.text)

const res = await fetch('https://mcp.plungeai.com/v1', { method: 'POST', headers: { Authorization: `Bearer ${process.env.PLUNGE_API_KEY}`, 'Content-Type': 'application/json', Accept: 'application/json, text/event-stream', }, body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'initialize', params: { protocolVersion: '2025-11-25', capabilities: {}, clientInfo: { name: 'docs-sample', version: '1.0.0' } } }), }) console.log(res.status, await res.text())

const res = await fetch('https://mcp.plungeai.com/v1', { method: 'POST', headers: { Authorization: `Bearer ${process.env.PLUNGE_API_KEY}`, 'Content-Type': 'application/json', Accept: 'application/json, text/event-stream', }, body: JSON.stringify({ jsonrpc: '2.0', id: 2, method: 'tools/list' }), }) console.log(res.status, await res.text())

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class Main { public static void main(String[] args) throws Exception { String json = "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2025-11-25\",\"capabilities\":{},\"clientInfo\":{\"name\":\"docs-sample\",\"version\":\"1.0.0\"}}}"; HttpRequest req = HttpRequest.newBuilder(URI.create("https://mcp.plungeai.com/v1")) .header("Authorization", "Bearer " + System.getenv("PLUNGE_API_KEY")) .header("Content-Type", "application/json") .header("Accept", "application/json, text/event-stream") .POST(HttpRequest.BodyPublishers.ofString(json)) .build(); HttpResponse<String> res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString()); System.out.println(res.statusCode() + " " + res.body()); } }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class Main { public static void main(String[] args) throws Exception { String json = "{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/list\"}"; HttpRequest req = HttpRequest.newBuilder(URI.create("https://mcp.plungeai.com/v1")) .header("Authorization", "Bearer " + System.getenv("PLUNGE_API_KEY")) .header("Content-Type", "application/json") .header("Accept", "application/json, text/event-stream") .POST(HttpRequest.BodyPublishers.ofString(json)) .build(); HttpResponse<String> res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString()); System.out.println(res.statusCode() + " " + res.body()); } }

curl -s https://mcp.plungeai.com/v1 \ -H "Authorization: Bearer $PLUNGE_API_KEY" \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"docs-sample","version":"1.0.0"}}}'

MCP endpoint (JSON-RPC)

Authorizations

Body

Response

Stream events

Planned: TI-33

Planned: TI-34