MCP examples

curl -sS https://<your-domain>/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {}
  }'

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": {
      "tools": {
        "listChanged": false
      }
    },
    "serverInfo": {
      "name": "cashcat-mcp",
      "version": "1.0.0"
    },
    "instructions": "Use cashcat_financial_overview and cashcat_full_context for comprehensive financial analysis."
  }
}

curl -sS https://<your-domain>/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "ping",
    "params": {}
  }'

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "ok": true,
    "timestamp": "2026-03-03T10:30:00Z"
  }
}

curl -sS https://<your-domain>/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/list",
    "params": {}
  }'

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "tools": [
      {
        "name": "cashcat_get",
        "description": "Read any CashCat REST GET endpoint (accounts, categories, groups, assignments, transactions, transfers, budget-left).",
        "inputSchema": {
          "type": "object",
          "additionalProperties": false,
          "required": ["endpoint"],
          "properties": {
            "endpoint": {
              "type": "string",
              "enum": ["accounts", "assignments", "categories", "categories/budget-left", "groups", "transactions", "transfers"]
            },
            "query": {
              "type": "object",
              "description": "Query params passed through to the selected endpoint.",
              "additionalProperties": {
                "anyOf": [{"type": "string"}, {"type": "number"}, {"type": "boolean"}]
              }
            },
            "paginate_all": {
              "type": "boolean",
              "description": "If true, keeps following cursor pagination until max_rows is reached.",
              "default": false
            },
            "max_rows": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10000,
              "default": 2000
            }
          }
        }
      },
      {
        "name": "cashcat_financial_overview",
        "description": "Get an advisory-friendly snapshot: net worth, budget health, overspending, and monthly cashflow.",
        "inputSchema": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "month": {
              "type": "string",
              "description": "Optional month in YYYY-MM."
            },
            "as_of_date": {
              "type": "string",
              "description": "Optional as-of date in YYYY-MM-DD."
            },
            "max_rows_for_summaries": {
              "type": "integer",
              "minimum": 100,
              "maximum": 10000,
              "default": 4000
            },
            "recent_items_limit": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 25
            }
          }
        }
      },
      {
        "name": "cashcat_full_context",
        "description": "Fetch a broad, structured financial context bundle across all major endpoints for deep analysis/advice.",
        "inputSchema": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "month": {
              "type": "string",
              "description": "Optional month in YYYY-MM."
            },
            "start_date": {
              "type": "string",
              "description": "Optional start date in YYYY-MM-DD for transaction/transfer windows."
            },
            "end_date": {
              "type": "string",
              "description": "Optional end date in YYYY-MM-DD for transaction/transfer windows."
            },
            "as_of_date": {
              "type": "string",
              "description": "Optional balance as-of date in YYYY-MM-DD."
            },
            "include_accounts": {"type": "boolean", "default": true},
            "include_categories": {"type": "boolean", "default": true},
            "include_groups": {"type": "boolean", "default": true},
            "include_assignments": {"type": "boolean", "default": true},
            "include_transactions": {"type": "boolean", "default": true},
            "include_transfers": {"type": "boolean", "default": true},
            "include_budget_left": {"type": "boolean", "default": true},
            "max_rows_per_endpoint": {
              "type": "integer",
              "minimum": 100,
              "maximum": 10000,
              "default": 4000
            }
          }
        }
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{...JSON formatted result...}"
      }
    ],
    "structuredContent": {
      // Actual tool response data
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32001,
    "message": "Unauthorized",
    "data": {
      "reason": "Invalid API key"
    }
  }
}