Skip to main content
If you’re building your own agent or using a framework that supports MCP, you can connect directly to the KonbiniAPI MCP server.

​
Endpoint

https://mcp.konbiniapi.com
The server uses the Streamable HTTP transport and requires a Bearer token on every request.

​
Authentication

The server implements OAuth 2.0 with dynamic client registration. Most MCP-compatible frameworks handle this automatically. If your framework supports OAuth discovery, point it at the server URL and it will handle the flow: 
GET https://mcp.konbiniapi.com/.well-known/oauth-protected-resource
GET https://mcp.konbiniapi.com/.well-known/oauth-authorization-server
The access token issued at the end of the flow is a native knbn_ API key — it can also be used directly against the REST API.

​
Making requests

Once authenticated, send MCP JSON-RPC requests to POST /: 
curl https://mcp.konbiniapi.com \
  -H "Authorization: Bearer knbn_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "call_endpoint",
      "arguments": {
        "endpoint_id": "tiktokGetUser",
        "params": { "username": "khaby.lame" }
      }
    },
    "id": 1
  }'

​
OpenAI Responses API

If you are building with the OpenAI Responses API, pass KonbiniAPI as an MCP tool and send your KonbiniAPI API key in the authorization field: 
{
  "model": "gpt-5",
  "input": "Find the right TikTok endpoint for a username lookup, then call it for khaby.lame.",
  "tools": [
    {
      "type": "mcp",
      "server_label": "konbiniapi",
      "server_url": "https://mcp.konbiniapi.com",
      "authorization": "knbn_your_api_key",
      "require_approval": "never"
    }
  ]
}
That keeps KonbiniAPI remote while still working in environments where your app manages OAuth or API keys itself.

​
Testing with MCP Inspector

The MCP Inspector is a useful tool for exploring and testing the server: 
npx @modelcontextprotocol/inspector
Set the transport to Streamable HTTP and the URL to https://mcp.konbiniapi.com.

​
Tools reference

See the tools reference for the full list of available tools, their parameters, and example responses.