MCP Payload Reference

Prev Next

Kentik’s AI Advisor MCP Server uses standard JSON-RPC 2.0 over HTTP. If you are building a custom integration rather than using an off-the-shelf client like Claude Desktop, refer to the payload structures below.

Notes:

  • This reference and the MCP Tools Reference are specifically for developers building custom AI agents or integrations with the Kentik MCP Server. Standard Model Context Protocol (MCP) clients like Claude Desktop handle these tools automatically in the background.

  • Your client must use MCP protocol version 2026-07-28 (latest as of Oct 23, 2026) or 2025-11-25. Clients using any earlier version, such as 2024-11-05, time out. See Getting Started.

Request Format

When your agent invokes a tool like ask_question or ask_followup, it sends a tools/call request containing the specific tool name and necessary arguments.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "ask_question",
    "arguments": {
      "prompt": "Your network question here"
    }
  }
}

Response Format

Successful tool executions return the AI's generated response mapped into a content array. This is typically returned as raw Markdown text, which your client application needs to render.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "AI-generated answer in Markdown format."
      }
    ]
  }
}

Progress Notifications

Because deep network queries can take up to 60 seconds, the server pushes asynchronous progress updates. Listen for these notifications to update your client's UI so the user knows the request hasn't hung.

{
  "jsonrpc": "2.0",
  "method": "notifications/progress",
  "params": {
    "progressToken": "unique-request-token",
    "progress": 50,
    "total": 100
  }
}