API-Football MCP Server

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "examples": [
      {
        "question": "What was Apple's revenue in 2024?"
      },
      {
        "question": "Any recent SEC filings for $NVDA?"
      },
      {
        "question": "Current price of bitcoin"
      }
    ],
    "properties": {
      "input": {
        "description": "Alias for question.",
        "type": "string"
      },
      "prompt": {
        "description": "Alias for question.",
        "type": "string"
      },
      "q": {
        "description": "Alias for question.",
        "type": "string"
      },
      "query": {
        "description": "Alias for question.",
        "type": "string"
      },
      "question": {
        "description": "Your question or request in natural language. Accepts query, q, prompt, text, input as aliases.",
        "type": "string"
      },
      "text": {
        "description": "Alias for question.",
        "type": "string"
      }
    },
    "required": [
      "question"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "input": {
        "description": "Alias for question.",
        "type": "string"
      },
      "prompt": {
        "description": "Alias for question.",
        "type": "string"
      },
      "q": {
        "description": "Alias for question.",
        "type": "string"
      },
      "query": {
        "description": "Alias for question.",
        "type": "string"
      },
      "question": {
        "description": "Your question or request in natural language. Accepts query, q, prompt, text, input as aliases.",
        "type": "string"
      },
      "text": {
        "description": "Alias for question.",
        "type": "string"
      }
    },
    "required": [
      "question"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "input": {
        "description": "Alias for question.",
        "type": "string"
      },
      "prompt": {
        "description": "Alias for question.",
        "type": "string"
      },
      "q": {
        "description": "Alias for question.",
        "type": "string"
      },
      "query": {
        "description": "Alias for question.",
        "type": "string"
      },
      "question": {
        "description": "Your question in natural language. Accepts query, q, prompt, text, input as aliases.",
        "type": "string"
      },
      "text": {
        "description": "Alias for question.",
        "type": "string"
      }
    },
    "required": [
      "question"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "limit": {
        "description": "Max passages to return (1-20, default 5).",
        "type": "number"
      },
      "query": {
        "description": "Natural-language query \u2014 what passages do you want? E.g. \"supply-chain risk\", \"fiscal year 2024 revenue\", \"drug interactions with warfarin\".",
        "type": "string"
      },
      "text": {
        "description": "The document text to search inside (max ~200K chars).",
        "type": "string"
      }
    },
    "required": [
      "text",
      "query"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "depth": {
        "description": "How many facets to research in parallel: quick=3 (single hop), standard=5 (default; adds a gap-recovery hop that re-angles unanswered facets + a contradictions[] scan across findings), thorough=8 (paid; adds a full iterative hop that chases leads + recovers gaps, plus the contradictions[] scan).",
        "enum": [
          "quick",
          "standard",
          "thorough"
        ],
        "type": "string"
      },
      "question": {
        "description": "The research question, in natural language. Broad/multi-part is fine \u2014 decomposition is the point.",
        "type": "string"
      }
    },
    "required": [
      "question"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "examples": [
      {
        "query": "look up FDA drug approvals"
      },
      {
        "query": "analyze housing market trends"
      }
    ],
    "properties": {
      "description": {
        "description": "Alias for query.",
        "type": "string"
      },
      "limit": {
        "description": "Maximum number of tools to return (default 20, max 50)",
        "type": "number"
      },
      "q": {
        "description": "Alias for query.",
        "type": "string"
      },
      "query": {
        "description": "Natural language description of what you want to do (e.g., \"analyze housing market trends\", \"look up FDA drug approvals\", \"find trade data between countries\"). Accepts task, q, description, search as aliases.",
        "type": "string"
      },
      "search": {
        "description": "Alias for query.",
        "type": "string"
      },
      "task": {
        "description": "Alias for query.",
        "type": "string"
      }
    },
    "required": [
      "query"
    ],
    "type": "object"
  },
  "risk_flags": [
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "type": {
        "description": "Entity type: \"company\" or \"drug\".",
        "enum": [
          "company",
          "drug"
        ],
        "type": "string"
      },
      "value": {
        "description": "For company: ticker (AAPL), CIK (0000320193), or name. For drug: brand or generic name (e.g., \"ozempic\", \"metformin\").",
        "type": "string"
      }
    },
    "required": [
      "type",
      "value"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "type": {
        "description": "Entity type: \"company\" or \"drug\".",
        "enum": [
          "company",
          "drug"
        ],
        "type": "string"
      },
      "values": {
        "description": "For company: 2\u20135 tickers/CIKs (e.g., [\"AAPL\",\"MSFT\"]). For drug: 2\u20135 names (e.g., [\"ozempic\",\"mounjaro\"]).",
        "items": {
          "type": "string"
        },
        "maxItems": 5,
        "minItems": 2,
        "type": "array"
      }
    },
    "required": [
      "type",
      "values"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": false
  },
  "capabilities": [
    "write",
    "network"
  ],
  "input_schema": {
    "properties": {
      "delivery": {
        "description": "Optional delivery channels in addition to the always-on persistent feed. {email:\"you@x.com\"} sends a templated alert per fired event. {sms:\"+15551234567\"} sends an SMS per event \u2014 must match the verified phone on the caller's account (verify at https://pipeworx.io/account first; 10/day cap). {webhook:\"https://...\"} POSTs each event JSON to your endpoint, HMAC-signed \u2014 the response includes delivery.webhook_secret (whsec_\u2026) ONCE; verify X-Pipeworx-Signature = sha256 HMAC of \"<X-Pipeworx-Timestamp>.<raw body>\". Auto-disabled after 10 consecutive failing runs.",
        "properties": {
          "email": {
            "description": "Email address to deliver alerts to. Validated against a standard pattern.",
            "type": "string"
          },
          "sms": {
            "description": "E.164 phone number, e.g. \"+15551234567\". Must match the account's verified phone.",
            "type": "string"
          },
          "webhook": {
            "description": "HTTPS URL to POST fired events to. https only; localhost/private hosts rejected. Signing secret returned once at subscribe time.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "params": {
        "description": "Type-specific filter. sec_8k: {ticker:\"AAPL\", items?:[\"5.02\",\"1.01\"]}. polymarket_edge: {topic:\"fed\", min_spread_bps?:500}. fred_series: {series_id:\"UNRATE\"}. patent_grant: {applicant:\"Apple Inc.\"}. clinical_trial: {sponsor?:\"Pfizer\", condition?:\"lung cancer\", phase?:\"PHASE3\"} (sponsor or condition required).",
        "type": "object"
      },
      "type": {
        "description": "Subscription type.",
        "enum": [
          "sec_8k",
          "polymarket_edge",
          "fred_series",
          "patent_grant",
          "clinical_trial"
        ],
        "type": "string"
      }
    },
    "required": [
      "type",
      "params"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": false
  },
  "capabilities": [
    "network"
  ],
  "input_schema": {
    "properties": {
      "id": {
        "description": "Subscription id (uuid) returned by subscribe.",
        "type": "string"
      }
    },
    "required": [
      "id"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "include_inactive": {
        "description": "Include cancelled subscriptions in the response (default false).",
        "type": "boolean"
      }
    },
    "required": [],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "limit": {
        "description": "Max events to return (1-200, default 50).",
        "type": "number"
      },
      "mark_read": {
        "description": "Flag the returned events read in the same call (default false).",
        "type": "boolean"
      },
      "since": {
        "description": "Optional ISO timestamp \u2014 return events fired_at >= this time.",
        "type": "string"
      },
      "type": {
        "description": "Optional \u2014 filter to one subscription type.",
        "type": "string"
      },
      "unread_only": {
        "description": "Return only events where read_at is null (default false).",
        "type": "boolean"
      }
    },
    "required": [],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "type": {
        "description": "Entity type. Only \"company\" supported today; person/place coming soon.",
        "enum": [
          "company"
        ],
        "type": "string"
      },
      "value": {
        "description": "Ticker (e.g., \"AAPL\") or zero-padded CIK (e.g., \"0000320193\"). Names not supported \u2014 use resolve_entity first if you only have a name.",
        "type": "string"
      }
    },
    "required": [
      "type",
      "value"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "since": {
        "description": "Window start \u2014 ISO date (\"2026-04-01\") or relative (\"7d\", \"30d\", \"3m\", \"1y\"). Use \"30d\" or \"1m\" for typical monitoring.",
        "type": "string"
      },
      "type": {
        "description": "Entity type. Only \"company\" supported today.",
        "enum": [
          "company"
        ],
        "type": "string"
      },
      "value": {
        "description": "Ticker (e.g., \"AAPL\") or zero-padded CIK (e.g., \"0000320193\").",
        "type": "string"
      }
    },
    "required": [
      "type",
      "value",
      "since"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "claim": {
        "description": "Natural-language factual claim, e.g., \"Apple's FY2024 revenue was $400 billion\" or \"Microsoft made about $100B in profit last year\".",
        "type": "string"
      },
      "tolerance_pct": {
        "description": "Max percent deviation still graded approximately_correct (0.5\u201350). Overrides the tolerance implied by the claim wording \u2014 set 1\u20132 for hallucination detection where any material error must be refuted. Default: implied by wording, capped at 5.",
        "type": "number"
      }
    },
    "required": [
      "claim"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "package": {
        "description": "npm package name. Scoped packages (e.g. \"@types/node\") are accepted.",
        "type": "string"
      },
      "version": {
        "description": "Specific version to check (e.g., \"18.3.1\"). Defaults to the latest published version when omitted.",
        "type": "string"
      }
    },
    "required": [
      "package"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "examples": [
      {
        "market": "will-bitcoin-reach-100k-in-july-2026"
      },
      {
        "market": "https://polymarket.com/event/will-bitcoin-hit-150k-by-june-30-2026"
      }
    ],
    "properties": {
      "depth": {
        "description": "quick = 2-3 evidence sources, thorough = full fan-out. Default thorough.",
        "enum": [
          "quick",
          "thorough"
        ],
        "type": "string"
      },
      "include_raw": {
        "description": "Default false. When false (recommended), FRED/FDA/GDELT/Federal-Register evidence is summarized to the few fields agents actually use \u2014 keeps responses under ~20KB. Pass true to get full upstream payloads (50KB-500KB) when you need to recompute deltas, cite specific observations, or post-process.",
        "type": "boolean"
      },
      "market": {
        "description": "Polymarket slug (\"will-bitcoin-hit-150k-by-june-30-2026\"), full URL (\"https://polymarket.com/event/...\"), or question text (\"Will Bitcoin hit $150k by June 30?\")",
        "type": "string"
      }
    },
    "required": [
      "market"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network",
    "financial"
  ],
  "input_schema": {
    "properties": {
      "event": {
        "description": "Single-event mode (use this if you know the specific Polymarket event): event slug like \"fed-decision-may-2026\" or \"when-will-bitcoin-hit-150k\". Full Polymarket URLs also accepted.",
        "type": "string"
      },
      "topic": {
        "description": "Cross-event mode (use this if you want to scan related events across the platform): a topic or seed question like \"Fed rate decision\" or \"Strait of Hormuz traffic returns to normal\". Tool searches Polymarket for related events and checks monotonicity across them.",
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "category_filter": {
        "description": "Comma-separated list to restrict the output: \"model_driven\" (crypto_price + news_momentum), \"structural_arbitrage\" (partition_overround), \"concentrated_longshot\". Combine like \"model_driven,structural_arbitrage\". Default: all.",
        "type": "string"
      },
      "limit": {
        "description": "Top N edges to return after ranking. Default 10, max 25.",
        "type": "number"
      },
      "max_spread_pp": {
        "description": "Tradeable-edge filter. Maximum bid/ask spread in percentage points on the representative market. Default null (no filter). Set to 2 to require tight books \u2014 anything wider eats most plausible edges.",
        "type": "number"
      },
      "min_edge_pp": {
        "description": "Minimum |edge| in percentage points to include (default 0.5). Edge is evaluated NET of slippage.",
        "type": "number"
      },
      "min_kelly": {
        "description": "Minimum half-Kelly fraction (as decimal, e.g. 0.005 = 0.5% of bankroll) to include single-leg opportunities. Default 0 (no filter). Skips opportunities that are too small to bet sensibly even if the edge is large.",
        "type": "number"
      },
      "min_liquidity": {
        "description": "Tradeable-edge filter. Minimum $ liquidity on the representative market (or for partition_overround, on at least one top_leg). Default 0 (no filter). Set to 5000 to drop thin-book opportunities where executing the edge would walk the book past breakeven.",
        "type": "number"
      },
      "min_partition_leg_kelly": {
        "description": "Minimum BEST per-leg half-Kelly fraction across a partition_overround opportunity's top_legs (or longshot_basket legs). Default 0 (no filter). Partition arbs always return kelly_fraction_half=0 at the parent level by design (basket trades don't compose to single-leg Kelly), so min_kelly never filters them \u2014 this knob applies to the per-leg Kelly inside top_legs instead. Use to suppress thin partitions whose individual leg edges aren't worth the per-leg slippage cost.",
        "type": "number"
      },
      "slippage_pp": {
        "description": "Assumed execution slippage in percentage points per leg (default 0.3). Subtracted from raw |edge| before ranking and Kelly sizing. Polymarket has zero trading fees as of 2024 but bid/ask + thin depth typically eats 20-50bp per trade. Bump for very thin partitions; drop to 0 if you have a smarter fill model.",
        "type": "number"
      },
      "window": {
        "description": "Polymarket volume window to filter markets. Default 1wk.",
        "enum": [
          "24hr",
          "1wk",
          "1mo"
        ],
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "examples": [
      {
        "topic": "fed"
      },
      {
        "topic": "btc"
      }
    ],
    "properties": {
      "kalshi_event_ticker": {
        "description": "Explicit Kalshi event ticker, e.g. \"KXFED-26OCT\". Overrides the topic-mapped Kalshi side.",
        "type": "string"
      },
      "polymarket_event_slug": {
        "description": "Explicit Polymarket event slug, e.g. \"fed-decision-in-june-825\". Overrides the topic-mapped Polymarket side.",
        "type": "string"
      },
      "topic": {
        "description": "Pre-mapped: fed | btc | cpi | gdp | sp500 | recession | next_pope | next_uk_pm | next_israel_pm | 2028_president",
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network",
    "financial"
  ],
  "input_schema": {
    "properties": {
      "event": {
        "description": "Basket mode: event slug or full polymarket.com URL \u2014 checks every leg of the partition.",
        "type": "string"
      },
      "market": {
        "description": "Single-market mode: market slug or full polymarket.com URL.",
        "type": "string"
      },
      "side": {
        "description": "Single-market: buy_yes | sell_yes | buy_no | sell_no (default buy_yes). Basket: sell_yes | buy_yes (default auto \u2014 sell if partition sum > 1, buy if < 1).",
        "type": "string"
      },
      "size_usd": {
        "description": "Single-market: USD to spend (buys) or target proceeds (sells). Basket: settlement notional \u2014 shares per leg, each paying $1 at resolution. Default 1000, clamp 10\u20131,000,000.",
        "type": "number"
      }
    },
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "days": {
        "description": "Lookback in days (default 14, clamp 2-30).",
        "type": "number"
      },
      "window": {
        "description": "Which polymarket_edges window family to read snapshots for: 24hr | 1wk | 1mo (default 1wk).",
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "window": {
        "description": "24h (default) | 7d | 30d. Shorter windows surface what's hot right now; longer windows show steady-state demand.",
        "enum": [
          "24h",
          "7d",
          "30d"
        ],
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "topic": {
        "description": "Optional focus area: finance | pharma | economics | real-estate | betting | weather | government | science | news. Omit for a cross-category spread.",
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network"
  ],
  "input_schema": {
    "properties": {
      "max_links": {
        "description": "Maximum number of link entries to include (default 25, max 50).",
        "type": "number"
      },
      "url": {
        "description": "Full URL of the site to summarize, e.g. \"https://example.com\" or a specific landing page.",
        "type": "string"
      }
    },
    "required": [
      "url"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "freeform_input_surface"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network",
    "secrets"
  ],
  "input_schema": {
    "properties": {
      "_apiKey": {
        "description": "Optional Anthropic API key (sk-ant-...) \u2014 only needed if \"anthropic\" is in models. Passed straight through to api.anthropic.com.",
        "type": "string"
      },
      "context": {
        "description": "Optional: a phrase locating the entity (e.g. \"Boston restaurant\", \"B2B SaaS\"). Helps disambiguate common names.",
        "type": "string"
      },
      "entity": {
        "description": "The thing to ask about. Brand/business name, product name, person, or topic. E.g. \"Pipeworx\", \"OpenInvoice\", \"Acme Corp pricing\".",
        "type": "string"
      },
      "models": {
        "description": "Which models to probe. Supported: \"workers-ai\" (free default), \"anthropic\" (requires _apiKey). Omit for just workers-ai.",
        "items": {
          "type": "string"
        },
        "type": "array"
      }
    },
    "required": [
      "entity"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "secret_material_access"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network",
    "secrets"
  ],
  "input_schema": {
    "properties": {
      "_apiKey": {
        "description": "Optional Anthropic API key \u2014 only if \"anthropic\" is in models. Passed to api.anthropic.com per probe.",
        "type": "string"
      },
      "context": {
        "description": "Optional shared context applied to every probe (e.g. \"B2B SaaS\", \"Boston restaurant\"). Disambiguates common names.",
        "type": "string"
      },
      "entities": {
        "description": "Array of 2-8 entities to compare (brand/business/product names). First entry treated as the \"subject\" for narrative; rest are competitors.",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "models": {
        "description": "Which models to probe. Supported: \"workers-ai\" (free default), \"anthropic\" (requires _apiKey). Omit for just workers-ai.",
        "items": {
          "type": "string"
        },
        "type": "array"
      }
    },
    "required": [
      "entities"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "secret_material_access"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "secrets"
  ],
  "input_schema": {
    "properties": {
      "claim_token": {
        "description": "Read the reply to a report you filed earlier: pass the `pwfb_\u2026` token that filing returned, with no other arguments. Returns the status and, once resolved, what actually changed.",
        "type": "string"
      },
      "context": {
        "description": "Optional structured context: which tool, pack, or vertical this relates to.",
        "properties": {
          "pack": {
            "description": "Pack slug (e.g., \"fred\")",
            "type": "string"
          },
          "tool": {
            "description": "Tool name (e.g., \"fred_get_series\")",
            "type": "string"
          },
          "vertical": {
            "description": "Vertical (e.g., \"housing\")",
            "type": "string"
          }
        },
        "type": "object"
      },
      "message": {
        "description": "Your feedback in plain text. Be specific (which tool, what error, what data was missing). 1-2 sentences typical, 2000 chars max.",
        "type": "string"
      },
      "type": {
        "description": "bug = something broke or returned wrong data. feature = a new tool or capability you wish existed. data_gap = data Pipeworx does not currently expose. praise = positive note. other = anything else.",
        "enum": [
          "bug",
          "feature",
          "data_gap",
          "praise",
          "other"
        ],
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": [
    "secret_material_access"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write"
  ],
  "input_schema": {
    "properties": {
      "key": {
        "description": "Memory key (e.g., \"subject_property\", \"target_ticker\", \"user_preference\")",
        "type": "string"
      },
      "value": {
        "description": "Value to store (any text \u2014 findings, addresses, preferences, notes)",
        "type": "string"
      }
    },
    "required": [
      "key",
      "value"
    ],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true
  },
  "capabilities": [
    "read"
  ],
  "input_schema": {
    "examples": [
      {
        "key": "user_research_topic"
      },
      {}
    ],
    "properties": {
      "key": {
        "description": "Memory key to retrieve (omit to list all keys)",
        "type": "string"
      }
    },
    "required": [],
    "type": "object"
  },
  "risk_flags": []
}

{
  "annotations": {
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  },
  "capabilities": [
    "write",
    "delete"
  ],
  "input_schema": {
    "examples": [
      {
        "key": "user_research_topic"
      }
    ],
    "properties": {
      "key": {
        "description": "Memory key to delete",
        "type": "string"
      }
    },
    "required": [
      "key"
    ],
    "type": "object"
  },
  "risk_flags": [
    "destructive_operation"
  ]
}

{
  "annotations": {
    "cost": {
      "all": 2
    },
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network",
    "secrets"
  ],
  "input_schema": {
    "examples": [
      {
        "_apiKey": "your-api-football-api-key",
        "league": 39,
        "season": 2024
      },
      {
        "_apiKey": "your-api-football-api-key",
        "next": 5,
        "team": 33
      }
    ],
    "properties": {
      "_apiKey": {
        "description": "BYO API-Football key (https://dashboard.api-football.com/register)",
        "type": "string"
      },
      "date": {
        "description": "YYYY-MM-DD \u2014 single-day fixtures",
        "type": "string"
      },
      "last": {
        "description": "Last N played matches for the team/league",
        "type": "number"
      },
      "league": {
        "description": "League ID (1 = FIFA World Cup, 39 = EPL, 140 = La Liga, 2 = Champions League \u2014 use league_search to find others)",
        "type": "number"
      },
      "next": {
        "description": "Next N upcoming matches for the team/league",
        "type": "number"
      },
      "season": {
        "description": "Season year (e.g. 2026)",
        "type": "number"
      },
      "team": {
        "description": "Team ID \u2014 use team_search to find",
        "type": "number"
      }
    },
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "secret_material_access"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network",
    "secrets"
  ],
  "input_schema": {
    "examples": [
      {
        "_apiKey": "your-api-football-api-key",
        "league": 39,
        "season": 2024
      },
      {
        "_apiKey": "your-api-football-api-key",
        "league": 140,
        "season": 2024
      }
    ],
    "properties": {
      "_apiKey": {
        "type": "string"
      },
      "league": {
        "description": "League ID (required)",
        "type": "number"
      },
      "season": {
        "description": "Season year (required, e.g. 2026)",
        "type": "number"
      }
    },
    "required": [
      "league",
      "season"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "secret_material_access"
  ]
}

{
  "annotations": {
    "cost": {
      "all": 2
    },
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network",
    "secrets"
  ],
  "input_schema": {
    "examples": [
      {
        "_apiKey": "your-api-football-api-key",
        "name": "Real Madrid"
      },
      {
        "_apiKey": "your-api-football-api-key",
        "country": "England",
        "name": "Manchester"
      }
    ],
    "properties": {
      "_apiKey": {
        "type": "string"
      },
      "country": {
        "description": "Country name to disambiguate",
        "type": "string"
      },
      "name": {
        "description": "Team name (e.g. \"France\", \"Real Madrid\")",
        "type": "string"
      }
    },
    "required": [
      "name"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "secret_material_access"
  ]
}

{
  "annotations": {
    "cost": {
      "all": 2
    },
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network",
    "secrets"
  ],
  "input_schema": {
    "examples": [
      {
        "_apiKey": "your-api-football-api-key",
        "name": "Premier League"
      },
      {
        "_apiKey": "your-api-football-api-key",
        "country": "Brazil",
        "name": "S\u00e9rie A"
      }
    ],
    "properties": {
      "_apiKey": {
        "type": "string"
      },
      "country": {
        "description": "Country name to filter",
        "type": "string"
      },
      "name": {
        "description": "Competition name (e.g. \"World Cup\", \"Champions League\", \"Premier League\")",
        "type": "string"
      }
    },
    "required": [
      "name"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "secret_material_access"
  ]
}

{
  "annotations": {
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network",
    "secrets"
  ],
  "input_schema": {
    "examples": [
      {
        "_apiKey": "your-api-football-api-key",
        "fixture": 1234567
      }
    ],
    "properties": {
      "_apiKey": {
        "type": "string"
      },
      "fixture": {
        "description": "Fixture ID \u2014 get from fixtures() output",
        "type": "number"
      }
    },
    "required": [
      "fixture"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "secret_material_access"
  ]
}

{
  "annotations": {
    "cost": {
      "all": 2
    },
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network",
    "secrets"
  ],
  "input_schema": {
    "examples": [
      {
        "team": "AC Milan"
      },
      {
        "league": 135,
        "season": 2025
      }
    ],
    "properties": {
      "_apiKey": {
        "description": "BYO API-Football key (https://dashboard.api-football.com/register)",
        "type": "string"
      },
      "league": {
        "description": "League id instead of a team \u2014 use league_search to find one.",
        "type": "number"
      },
      "season": {
        "description": "Season start year, e.g. 2025. Defaults to the current season.",
        "type": "number"
      },
      "team": {
        "description": "Club name, e.g. \"AC Milan\". Resolved to its team id for you.",
        "type": "string"
      }
    },
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "secret_material_access"
  ]
}

{
  "annotations": {
    "cost": {
      "all": 2
    },
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network",
    "secrets"
  ],
  "input_schema": {
    "examples": [
      {
        "team": "AC Milan"
      }
    ],
    "properties": {
      "_apiKey": {
        "description": "BYO API-Football key.",
        "type": "string"
      },
      "team": {
        "description": "Club name, e.g. \"AC Milan\". Resolved to its team id for you.",
        "type": "string"
      }
    },
    "required": [
      "team"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "secret_material_access"
  ]
}

{
  "annotations": {
    "cost": {
      "all": 2
    },
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  },
  "capabilities": [
    "read",
    "network",
    "secrets"
  ],
  "input_schema": {
    "examples": [
      {
        "_apiKey": "your-api-football-api-key",
        "last": 10,
        "team1": 33,
        "team2": 34
      }
    ],
    "properties": {
      "_apiKey": {
        "type": "string"
      },
      "last": {
        "description": "Last N H2H matches (default 5)",
        "type": "number"
      },
      "team1": {
        "description": "First team ID",
        "type": "number"
      },
      "team2": {
        "description": "Second team ID",
        "type": "number"
      }
    },
    "required": [
      "team1",
      "team2"
    ],
    "type": "object"
  },
  "risk_flags": [
    "arbitrary_network_egress",
    "secret_material_access"
  ]
}

• For each high-risk tool (delete, exec, or network-egress capable), add a `confirm`/`dry_run` parameter or a two-step confirmation flow.
• Document the safeguard in the tool's description so clients and agents know confirmation is required before execution.
• Revalidate and confirm `action_safety_probe` reports the safeguard as detected.

• Return `Mcp-Session-Id` and `Mcp-Protocol-Version` headers consistently on streamable HTTP responses.
• Honor `DELETE` session teardown and return `404` when a deleted session is reused.
• Reject invalid protocol-version headers with `400 Bad Request`.

• Update the server's advertised protocol version to a current MCP revision (2025-06-18 or later).
• Return the negotiated version consistently in both the `initialize` response and the `MCP-Protocol-Version` header.
• Revalidate and confirm `protocol_version_probe` reports `ok`.

• Serve `/.well-known/openid-configuration` with `issuer`, `jwks_uri`, `authorization_endpoint`, and `token_endpoint`.
• List supported grant types in `grant_types_supported` and scopes in `scopes_supported`.
• Revalidate and confirm the `openid_configuration` check returns `ok`.

• Persist session state keyed by `Mcp-Session-Id` so a client can reconnect after a dropped connection.
• Honor `Last-Event-ID` on GET reconnects to replay missed SSE events instead of erroring.
• Revalidate and confirm `session_resume_probe` no longer returns `warning`.

• Advertise `completions`, pagination cursors, and `tasks` only when they are actually supported.
• Return `nextCursor` on large list operations when pagination is available.
• Document task support and whether it requires step-up auth.

• Add the capabilities you actually support (`roots`, `sampling`, `elicitation`) to the `capabilities` object returned from `initialize`.
• Only advertise a capability once the corresponding request/response flow is implemented end to end.
• Revalidate and confirm `advanced_capabilities_probe` reflects the updated capability set.