MCP Documentation

Use the Model Context Protocol endpoint to let AI orchestration tools manage links, workspaces, analytics, and API key workspace defaults.

Resolved Server Domain

This page uses NEXT_PUBLIC_SERVER_URL when configured, otherwise it falls back to the current browser origin.

Server Base URL

https://a.i6t.co.za

MCP Endpoint

https://a.i6t.co.za/mcp

Required Headers

All MCP calls require API key auth and a session id after initialize.

Content-Type: application/json
Accept: application/json, text/event-stream
x-api-key: <YOUR_API_KEY>
mcp-session-id: <SESSION_ID>  # required after initialize

Handshake Flow

Initialize once, then reuse mcp-session-id fortools/list and tools/call.

curl -sS -D mcp-init-headers.txt \
  -X POST "https://a.i6t.co.za/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: $MCP_API_KEY" \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": {
        "name": "curl-client",
        "version": "1.0.0"
      }
    }
  }'

Common Tool Calls

Examples for common URL shortener operations.

Get link by short code

{
  "jsonrpc": "2.0",
  "id": 11,
  "method": "tools/call",
  "params": {
    "name": "get_link_by_short_code",
    "arguments": {
      "shortCode": "campaign-2026"
    }
  }
}

Create short link

{
  "jsonrpc": "2.0",
  "id": 12,
  "method": "tools/call",
  "params": {
    "name": "create_short_link",
    "arguments": {
      "destinationUrl": "https://example.com/landing",
      "title": "Campaign Landing",
      "customCode": "campaign-2026",
      "expiresAt": "2026-12-31T23:59:59.000Z"
    }
  }
}

Delete link

{
  "jsonrpc": "2.0",
  "id": 13,
  "method": "tools/call",
  "params": {
    "name": "delete_link",
    "arguments": {
      "id": "00000000-0000-0000-0000-000000000000"
    }
  }
}

Node.js Example

Minimal script for initialize + tools/list.

const MCP_URL = "https://a.i6t.co.za/mcp";
const API_KEY = process.env.MCP_API_KEY;

if (!API_KEY) throw new Error("MCP_API_KEY is required");

const headers = {
  "Content-Type": "application/json",
  Accept: "application/json, text/event-stream",
  "x-api-key": API_KEY,
};

const initRes = await fetch(MCP_URL, {
  method: "POST",
  headers,
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "initialize",
    params: {
      protocolVersion: "2024-11-05",
      capabilities: {},
      clientInfo: { name: "node-client", version: "1.0.0" },
    },
  }),
});

const sessionId = initRes.headers.get("mcp-session-id");
if (!sessionId) throw new Error("No mcp-session-id returned");

const toolsRes = await fetch(MCP_URL, {
  method: "POST",
  headers: { ...headers, "mcp-session-id": sessionId },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 2,
    method: "tools/list",
    params: {},
  }),
});

console.log(await toolsRes.text());