Skip to main content

API Overview

DEB Cloud exposes tools via the Model Context Protocol (MCP), using JSON-RPC 2.0 over HTTP.

Base URL

https://mcp.debytes.io/mcp

Request Format

All requests use HTTP POST with a JSON body:
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tool_name",
    "arguments": { }
  }
}

Authentication

Include your API key as a Bearer token in the Authorization header:
Authorization: Bearer deb_your_api_key_here

Response Format

Successful responses return tool results in the content array:
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"key\": \"value\"}"
      }
    ]
  }
}
Tool results are JSON-encoded strings in the text field. Parse them to access the data.

Available Methods

MethodDescription
tools/listList all available tools and their schemas
tools/callExecute a tool with arguments

Caching

Results may be cached for faster response and lower credit cost. Cached results cost 25% of the normal credit cost. The system serves cached results automatically when available.

Rate Limits

Each API key has a per-minute request limit based on your plan. Exceeding the limit returns a JSON-RPC error with details.