`odds_api_quota`

Pack: odds-api · Endpoint: https://gateway.pipeworx.io/odds-api/mcp

Monthly request credits left and used on the key serving this call, read from The Odds API usage headers. Says whether the odds and scores tools can return data right now and how large the plan is.

Example call

Arguments

{}

curl

curl -X POST https://gateway.pipeworx.io/odds-api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"odds_api_quota","arguments":{}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('odds_api_quota', {});

Response shape

Always returns: found

Field	Type	Description
`found`	boolean	False when The Odds API did not return usage headers on this response.
`remaining`	integer \| null	Request credits left on the key for the current billing month.
`used`	integer \| null	Request credits already spent this billing month.
`plan_requests`	integer \| null	Plan size for the month (remaining + used).
`last_call_cost`	integer \| null	Credits the caller’s previous request consumed.
`exhausted`	boolean \| null	True when no credits remain, so the metered odds and scores tools cannot return data.
`checked_at`	string	When the balance was read, ISO 8601.
`note`	string	How the monthly reset behaves.
`reason`	string	Present when found is false: why the balance could not be read.
`hint`	string	Present when found is false: what to call instead to tell a spent quota from a bad key.

Full JSON Schema

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean",
      "description": "False when The Odds API did not return usage headers on this response."
    },
    "remaining": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Request credits left on the key for the current billing month."
    },
    "used": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Request credits already spent this billing month."
    },
    "plan_requests": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Plan size for the month (remaining + used)."
    },
    "last_call_cost": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Credits the caller's previous request consumed."
    },
    "exhausted": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "True when no credits remain, so the metered odds and scores tools cannot return data."
    },
    "checked_at": {
      "type": "string",
      "description": "When the balance was read, ISO 8601."
    },
    "note": {
      "type": "string",
      "description": "How the monthly reset behaves."
    },
    "reason": {
      "type": "string",
      "description": "Present when found is false: why the balance could not be read."
    },
    "hint": {
      "type": "string",
      "description": "Present when found is false: what to call instead to tell a spent quota from a bad key."
    }
  },
  "required": [
    "found"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "odds-api": {
      "url": "https://gateway.pipeworx.io/odds-api/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

odds_api_quota