unplain-io MCP API
Model Context Protocol endpoint. One multiplexed JSON-RPC path, API key required.
Model Context Protocol endpoint. One multiplexed JSON-RPC path, API key required.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/unplain-io:unplain-io-mcp-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Unplain Io MCP API
version: 1.0.0
contact:
name: Unplain
email: info@unplain.io
url: https://unplain.io/developers
termsOfService: https://unplain.io/terms
description: 'Operations tagged MCP across 2 of this provider''s published API definitions: app-unplain-io-openapi.json, unplain-io-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://app.unplain.io
description: Unplain application API
tags:
- name: MCP
description: Model Context Protocol endpoint. One multiplexed JSON-RPC path, API key required.
externalDocs:
description: Setup guide
url: https://unplain.io/mcp
paths:
/api/mcp:
summary: Model Context Protocol endpoint (Streamable HTTP)
description: 'The single MCP endpoint. It is stateless: no `Mcp-Session-Id` is issued, so every request stands alone and no session has to be kept consistent across replicas.'
post:
tags:
- MCP
security:
- ApiKey: []
operationId: mcpRpc
summary: Send a JSON-RPC message
description: 'Send one JSON-RPC request, notification or response. Per the Streamable HTTP transport the client must send `Accept: application/json, text/event-stream`; the reply is either a single JSON object or an SSE stream.'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcRequest'
examples:
toolsList:
summary: List the available tools
value:
jsonrpc: '2.0'
id: 1
method: tools/list
getAccount:
summary: Read the account's plan and limits
value:
jsonrpc: '2.0'
id: 2
method: tools/call
params:
name: get_account
arguments: {}
responses:
'200':
description: A JSON-RPC response, or an SSE stream carrying one.
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcResponse'
text/event-stream:
schema:
type: string
description: Server-Sent Events framing.
'202':
description: A notification or response was accepted. No body.
'401':
description: Authentication failed. The body is a JSON-RPC error object whose `message` names both the problem and the fix, and `WWW-Authenticate` carries an RFC 6750 bearer challenge.
headers:
WWW-Authenticate:
description: RFC 6750 challenge, for example `Bearer realm="Unplain MCP"`.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcError'
example:
jsonrpc: '2.0'
error:
code: -32001
message: 'No Unplain API key was sent. Add an ''Authorization: Bearer <your key>'' header. Keys are created in Unplain under Account settings, API keys.'
id: null
'413':
description: Request body larger than 4 MiB.
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcError'
'429':
description: Too many failed authentication attempts from this address.
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcError'
'503':
description: Unplain cannot verify API keys right now.
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcError'
get:
tags:
- MCP
security:
- ApiKey: []
operationId: mcpStream
summary: Open a server-to-client SSE stream
description: 'Requires `Accept: text/event-stream`. Used by clients that listen for server-initiated messages.'
responses:
'200':
description: An SSE stream.
content:
text/event-stream:
schema:
type: string
'401':
description: Authentication failed. The body is a JSON-RPC error object whose `message` names both the problem and the fix, and `WWW-Authenticate` carries an RFC 6750 bearer challenge.
headers:
WWW-Authenticate:
description: RFC 6750 challenge, for example `Bearer realm="Unplain MCP"`.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcError'
example:
jsonrpc: '2.0'
error:
code: -32001
message: 'No Unplain API key was sent. Add an ''Authorization: Bearer <your key>'' header. Keys are created in Unplain under Account settings, API keys.'
id: null
'405':
description: This endpoint offers no stream for that request.
'413':
description: Request body larger than 4 MiB.
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcError'
'429':
description: Too many failed authentication attempts from this address.
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcError'
'503':
description: Unplain cannot verify API keys right now.
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcError'
delete:
tags:
- MCP
security:
- ApiKey: []
operationId: mcpEndSession
summary: Terminate a session
description: Accepted for protocol conformance. This server is stateless, so there is no session to discard.
responses:
'200':
description: Acknowledged.
'401':
description: Authentication failed. The body is a JSON-RPC error object whose `message` names both the problem and the fix, and `WWW-Authenticate` carries an RFC 6750 bearer challenge.
headers:
WWW-Authenticate:
description: RFC 6750 challenge, for example `Bearer realm="Unplain MCP"`.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcError'
example:
jsonrpc: '2.0'
error:
code: -32001
message: 'No Unplain API key was sent. Add an ''Authorization: Bearer <your key>'' header. Keys are created in Unplain under Account settings, API keys.'
id: null
'413':
description: Request body larger than 4 MiB.
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcError'
'429':
description: Too many failed authentication attempts from this address.
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcError'
'503':
description: Unplain cannot verify API keys right now.
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcError'
servers:
- url: https://app.unplain.io
description: Unplain application API
components:
schemas:
JsonRpcErrorObject:
type: object
required:
- code
- message
properties:
code:
type: integer
message:
type: string
description: 'Written for the person whose assistant just failed: it names the problem and the fix, and clients surface it verbatim.'
JsonRpcResponse:
type: object
required:
- jsonrpc
properties:
jsonrpc:
type: string
const: '2.0'
id:
type:
- string
- integer
- 'null'
result:
type: object
error:
$ref: '#/components/schemas/JsonRpcErrorObject'
JsonRpcRequest:
type: object
required:
- jsonrpc
- method
properties:
jsonrpc:
type: string
const: '2.0'
id:
type:
- string
- integer
method:
type: string
examples:
- initialize
- tools/list
- tools/call
params:
type: object
JsonRpcError:
type: object
required:
- jsonrpc
- error
- id
properties:
jsonrpc:
type: string
const: '2.0'
error:
$ref: '#/components/schemas/JsonRpcErrorObject'
id:
type:
- string
- integer
- 'null'
securitySchemes:
ApiKey:
type: http
scheme: bearer
bearerFormat: unp_<base64url secret>
description: 'An Unplain API key, created under Account settings, API keys, and sent as `Authorization: Bearer unp_...`. The key carries exactly the capabilities of the account''s plan: there is no separate API tier. Scopes are granted per key and enforced per MCP tool: `brand_themes:read`, `brand_themes:write`, `projects:read`, `projects:write`, `exports:write`, `ai_cover:write`, `ai_image:write`.'
externalDocs:
description: Unplain developer documentation
url: https://unplain.io/developers
x-refined-from:
- app-unplain-io-openapi.json
- unplain-io-openapi.json