Skip to main content

​
MCP / API

Connect to DEB Cloud programmatically using the Model Context Protocol (MCP). MCP uses JSON-RPC 2.0 over HTTP.

​
Base URL

https://mcp.debytes.io/mcp

​
Protocol

All requests use HTTP POST with JSON-RPC 2.0 format.

​
Request Format

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tool_name",
    "arguments": {
      "param1": "value1"
    }
  }
}

​
Authentication

Include your API key as a Bearer token: 
Authorization: Bearer deb_your_api_key_here

​
List Available Tools

To discover all available tools and their parameters: 
curl -X POST https://mcp.debytes.io/mcp \
  -H "Authorization: Bearer deb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

​
Call a Tool

curl -X POST https://mcp.debytes.io/mcp \
  -H "Authorization: Bearer deb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "scrape_jobs",
      "arguments": {
        "query": "AI Engineer",
        "platforms": ["indeed", "linkedin"],
        "location": "London"
      }
    }
  }'

​
MCP Client Integration

DEB Cloud works with any MCP-compatible client. Configure your client with:
SettingValue
Server URLhttps://mcp.debytes.io/mcp
TransportHTTP (Streamable)
AuthBearer token

​
Error Handling

MCP errors follow JSON-RPC 2.0 conventions: 
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "Monthly quota exceeded"
  }
}
Error CodeMeaning
-32000Application error (quota, rate limit, validation)
-32601Method not found
-32602Invalid parameters