Profitabul Agent API

Quick Start

Get connected in three steps:

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer pab_live_a1b2c3d4e5f6...

Managing your key

• Create: Settings → Integrations → "Generate API Key"
• Rotate: Click "Regenerate" to create a new key (revokes the old one)
• Revoke: Click "Revoke" to disable the key immediately

Keys are hashed server-side with SHA-256. We never store your plaintext key after initial display.

MCP Setup

The Profitabul Agent API implements the Model Context Protocol over HTTP JSON-RPC. Connect any MCP-compatible client.

Endpoint

https://agents.profitabul.ai/mcp

Claude Desktop / Claude Code

{
  "mcpServers": {
    "profitabul": {
      "url": "https://agents.profitabul.ai/mcp",
      "headers": {
        "Authorization": "Bearer pab_live_YOUR_KEY_HERE"
      }
    }
  }
}

Cursor / VS Code

{
  "mcpServers": {
    "profitabul": {
      "url": "https://agents.profitabul.ai/mcp",
      "headers": {
        "Authorization": "Bearer pab_live_YOUR_KEY_HERE"
      }
    }
  }
}

Verify connection

curl -X POST https://agents.profitabul.ai/mcp \
  -H "Authorization: Bearer pab_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

You should get back a response with protocolVersion and serverInfo.

OpenClaw / ClawHub

Profitabul is available as a ClawHub skill for OpenClaw agents.

Install from ClawHub

clawhub install profitabul/profitabul-mcp

Configure environment

Add your API key to ~/.clawdbot/.env:

PROFITABUL_API_KEY=pab_live_YOUR_KEY_HERE

Configure mcporter

Add to config/mcporter.json:

{
  "mcpServers": {
    "profitabul": {
      "baseUrl": "https://agents.profitabul.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${PROFITABUL_API_KEY}"
      }
    }
  }
}

Verify

mcporter list profitabul

REST API

The same data is available over standard HTTP REST. Base URL:

https://agents.profitabul.ai/v1

OpenAPI spec: https://agents.profitabul.ai/openapi.json

Tools Reference

16 tools across market intelligence, historical analysis, paper trading, and live execution.

{
  "symbol": "SPX",
  "price": { "last": 6052.75, "dayChange": +12.34 },
  "gex": {
    "kingNode": 6050, "zeroGamma": 5980,
    "ceiling": 6100, "floor": 5925
  },
  "gexBias": { "regime": "positive", "expectedBehavior": "mean-reverting" },
  "vix": { "value": 16.2, "trend": "falling", "percentile": 32 }
}

Supported Symbols

Micro aliases (MES, MNQ, MGC, SIL) are automatically resolved to their full-size equivalents for data queries. Live execution uses micro contracts directly.

Rate Limits

When rate limited, the API returns HTTP 429 Too Many Requests with a Retry-After header indicating seconds to wait.

Error Handling

MCP tool calls return errors in the standard isError: true format. REST endpoints return appropriate HTTP status codes:

Recommended Workflow