Skip to directory

About BALLDONTLIE MCP

Official hosted BALLDONTLIE MCP generates API tools for sports and account data from 27 public OpenAPI specifications.

What you can use it for

  • Sports data API
Connection and setup
Hosting
hosted
Transport
Streamable HTTP
Endpoint
Local process; no hosted endpoint documented
Authentication
Not documented

Requirements

  • BALLDONTLIE account and API key
  • MCP client supporting remote Streamable HTTP with custom Authorization header

Setup steps

  1. Create an account and API key through BALLDONTLIE's official site/API account flow.
  2. Add the remote Streamable HTTP endpoint https://mcp.balldontlie.io/mcp and set Authorization: Bearer <BALLDONTLIE_API_KEY> in secure client headers.
  3. Reload/reconnect the MCP server and call tools/list to inspect current names, schemas, and annotations.
  4. Verify with a harmless read such as listing NBA teams.
Tools 7+

Crawl4AI verified the official repository reports 529 generated tools across 27 OpenAPI specifications. This record stores the 7 account tool identifiers explicitly listed in the README; the full generated sports/API catalog is larger and requires authenticated runtime listing.

  • account_signup

    Create a BALLDONTLIE account; the official server documents this sensitive tool as disabled unless ENABLE_SENSITIVE_ACCOUNT_TOOLS=true.

    01
  • account_rotate_api_key

    Rotate the account API key; disabled by default because it changes credentials.

    02
  • account_change_subscription

    Change the account subscription; disabled by default.

    03
  • account_cancel_subscription

    Cancel the account subscription; disabled by default.

    04
  • account_create_checkout

    Create a hosted checkout session; disabled by default.

    05
  • account_get_billing_portal

    Get a hosted billing portal URL; disabled by default.

    06
  • account_get_me

    Get the current account profile; the API key field is omitted.

    07

This server’s available tools can vary by account, permissions, or configuration. The list shown is not its full runtime catalog.

Limitations and notes
  • All requests require a BALLDONTLIE API key.
  • Six credential, subscription, cancellation, checkout, or billing-portal tools are disabled unless ENABLE_SENSITIVE_ACCOUNT_TOOLS=true.
  • Live runtime count is reported by /health and can differ from documentation snapshot.
Original sources
  • publisher identity

    Publisher GitHub organization describes itself as The Sports API Company and links the official repository.

  • official registry manifest

    Official server manifest establishes the MCP Registry identity and deployment package metadata.

  • maintainer documentation

    Current publisher or maintainer documentation reviewed 2026-10-28T19:00:00.000Z.

Documentation checked 2026-10-29T00:00:00Z. Connection has not been runtime tested.