API Reference

Complete reference for Knotie AI Pro MCP API endpoints

Administer your partner account (customers, VPS, credits, billing, agents) via MCP using your pkt_ key. 135 tools for AI agents.

Partner REST API→

Same 135 partner operations, exposed as a deterministic REST + OpenAPI 3.1 API for scripts, CI, and no-code tools.

Authentication

Method 1: Header-based Authentication

Use separate headers for API key and partner email:

X-API-Key: pkt_your_api_key

X-Partner-Email: [email protected]

Content-Type: application/json

Method 2: Authorization Header (Recommended)

Standard Authorization header compatible with MCP client tools:

Authorization: Basic base64(api_key:email)

Content-Type: application/json

💡 Tip: When you create an API key in the partner portal, we automatically generate the Authorization header for you!

Example Request

# Using Authorization header (recommended)

curl -H "Authorization: Basic your_auth_token" \

-H "Content-Type: application/json" \

https://analytics.knotie-ai.pro/mcp/capabilities

Three hosts, and they are not interchangeable. The /mcp/* endpoints on this page live on the analytics service at analytics.knotie-ai.pro and use the header / Basic scheme above. The Partner MCP Gateway and Partner REST API live on mcp.knotie-ai.pro and take your pkt_ key as Authorization: Bearer — never Basic. Partner routes under /api/partner/ (including customer onboarding) are on the main app at knotie-ai.pro or your own white-label domain. Each entry below shows the host it actually needs.

Endpoints

Authentication

Customer Management

Partner Customer Onboarding

Agent Management

Feature Management

Real-time

MCP Integration

Partner MCP Gateway

Partner REST API

GET

https://analytics.knotie-ai.pro/mcp/capabilities

Get Capabilities

Retrieve available MCP capabilities and partner information

Headers

X-API-KeyRequired

pkt_your_api_key

X-Partner-EmailRequired

[email protected]

Response

{
  "partner_id": "uuid",
  "partner_name": "Your Business Name",
  "partner_email": "[email protected]",
  "capabilities": [
    {
      "name": "create_customer",
      "description": "Create new customers",
      "endpoint": "/mcp/customers"
    }
  ],
  "total_capabilities": 6,
  "last_updated": "2024-01-01T00:00:00Z"
}

cURL Examples

Using Headers (Traditional)

curl -X GET \
  -H "X-API-Key: pkt_your_api_key" \
  -H "X-Partner-Email: [email protected]" \
  https://analytics.knotie-ai.pro/mcp/capabilities

Using Authorization Header (Recommended)

curl -X GET \
  -H "Authorization: Basic your_auth_token" \
  https://analytics.knotie-ai.pro/mcp/capabilities

💡 Note: Replace "your_auth_token" with the Authorization header generated in your partner portal when creating an API key.