Web Interface (chatgpt.com)

1. Go to Settings > Security and login and enable Developer mode
2. Open the Plugins page and click the + button
3. Enter the name as 'The Racing API'
4. Under Connection, enter the MCP Server URL:
   https://mcp.theracingapi.com Copy
5. Ensure Authentication is set to OAuth
6. Create the connection — you will be redirected to a login page — enter your Racing API username and password to authorize the connection
7. Once authenticated, The Racing API tools will be available in your conversations

Business, Enterprise & Edu plans: a workspace admin may need to allow developer mode under Workspace Settings > Permissions & Roles.

API (Responses API)

Connect to the MCP server programmatically using the Responses API, replacing the placeholder values with your API credentials:

{
  "model": "gpt-6-astra",
  "tools": [
    {
      "type": "mcp",
      "server_label": "the-racing-api",
      "server_url": "https://mcp.theracingapi.com/",
      "headers": {
        "X-RacingAPI-Username": "YOUR_USERNAME",
        "X-RacingAPI-Password": "YOUR_PASSWORD"
      },
      "require_approval": "never"
    }
  ],
  "input": "What are today's racecards?"
}

Codex (CLI)

Add the following to your Codex configuration file, replacing the placeholder values with your API credentials:

[mcp_servers.the-racing-api]
url = "https://mcp.theracingapi.com/"

[mcp_servers.the-racing-api.http_headers]
X-RacingAPI-Username = "YOUR_USERNAME"
X-RacingAPI-Password = "YOUR_PASSWORD"

Prefer a browser login? Run codex mcp add the-racing-api --url https://mcp.theracingapi.com/, then codex mcp login the-racing-api and sign in with your Racing API username and password.

Web Interface (gemini.google.com)

1. Make sure Keep Activity is turned on for your Google Account
2. In the Gemini web app, go to Settings > Connected Apps
3. Under Custom apps, click Add a custom app and enter the MCP server URL:
   https://mcp.theracingapi.com Copy
4. Click Next and complete the OAuth flow — you will be redirected to a login page where you can enter your Racing API username and password
5. Once connected, The Racing API tools will be available in Gemini chat and Gemini Spark, on the web and in the Gemini mobile app

Gemini CLI

Run the following command in your terminal, replacing the placeholder values with your API credentials:

gemini mcp add --transport http \
  the-racing-api \
  https://mcp.theracingapi.com/ \
  --header "X-RacingAPI-Username: YOUR_USERNAME" \
  --header "X-RacingAPI-Password: YOUR_PASSWORD"

Alternatively, add the following to your Gemini CLI settings file:

{
  "mcpServers": {
    "the-racing-api": {
      "httpUrl": "https://mcp.theracingapi.com/",
      "headers": {
        "X-RacingAPI-Username": "YOUR_USERNAME",
        "X-RacingAPI-Password": "YOUR_PASSWORD"
      }
    }
  }
}

Web Interface (grok.com)

1. Go to grok.com/connectors
2. Click New Connector, then select Custom
3. Enter the MCP server URL:
   https://mcp.theracingapi.com Copy
4. Complete the authentication flow — you will be redirected to a login page where you can enter your Racing API username and password
5. Once connected, The Racing API tools will be available in your conversations

Business & Enterprise plans: a team admin may need to provision the connector via console.x.ai > Grok Business > Connectors.

xAI API

Connect to the MCP server via the xAI API, replacing the placeholder values with your API credentials:

{
  "model": "grok-4.7",
  "tools": [
    {
      "type": "mcp",
      "server_label": "the-racing-api",
      "server_url": "https://mcp.theracingapi.com/",
      "headers": {
        "X-RacingAPI-Username": "YOUR_USERNAME",
        "X-RacingAPI-Password": "YOUR_PASSWORD"
      }
    }
  ],
  "input": [
    {
      "role": "user",
      "content": "What are today's racecards?"
    }
  ]
}

Lovable App

1. Open Connectors in the Lovable dashboard
2. Click the + button (top right) and select MCP server
3. Enter the server name: The Racing API
4. Leave the connection type as Direct connection
5. Enter the server URL:
   https://mcp.theracingapi.com Copy
6. Ensure the authentication method is set to OAuth
7. Click Add & authorize — you will be redirected to a login page where you can enter your Racing API username and password
8. Once authorized, The Racing API tools will be available as contextual data for the Lovable Agent

Note: MCP connectors act as chat connectors — they provide contextual data while building, but cannot be used inside your published app. To use racing data in a published app, call the REST API directly.

Web Interface (perplexity.ai)

1. Go to Settings > Connectors
2. Add a custom remote connector
3. Enter the connector name: The Racing API
4. Enter the MCP server URL:
   https://mcp.theracingapi.com Copy
5. Select the Streamable HTTP transport and set authentication to OAuth 2.0
6. Save the connector — you will be redirected to a login page where you can enter your Racing API username and password
7. Once authenticated, The Racing API tools will be available in your conversations

Cursor

Add the following to your Cursor MCP configuration file. Use ~/.cursor/mcp.json to make the server available in all projects, or .cursor/mcp.json inside a project for that project only. No credentials go in the file — Cursor will open a browser login the first time it connects:

{
  "mcpServers": {
    "the-racing-api": {
      "url": "https://mcp.theracingapi.com/"
    }
  }
}

1. Save the file, then open Customize in the Cursor sidebar (older versions: Settings > Tools & MCP) and make sure The Racing API is toggled on
2. When Cursor prompts you to log in, open the login page in your browser and sign in with your Racing API username and password
3. Return to Cursor — once the server shows as connected, The Racing API tools will be available to the agent

Signing in: the login uses your Racing API username and password (the same HTTP Basic auth credentials as the REST API — there are no separate API keys). If you change plan or add a regional add-on, it is picked up on your next fresh sign-in.

If you need to sign in again: remove The Racing API server and add it again (from Customize, or by editing mcp.json), then reconnect to trigger a new browser login.

VS Code (GitHub Copilot)

1. Open the Command Palette (Cmd/Ctrl+Shift+P) and run MCP: Add Server
2. Choose HTTP as the server type
3. Enter the server URL:
   https://mcp.theracingapi.com/ Copy
4. Give the server a name (for example the-racing-api) and choose whether to save it to the workspace or your user settings
5. When VS Code prompts you to allow authentication, accept — a browser login page will open where you can sign in with your Racing API username and password
6. Once authenticated, The Racing API tools will be available in Copilot agent mode — select the Configure Tools button in the chat input to see them

Alternatively, add the following to your MCP configuration file. No credentials go in the file — VS Code will run the browser login the first time it connects:

{
  "servers": {
    "the-racing-api": {
      "type": "http",
      "url": "https://mcp.theracingapi.com/"
    }
  }
}

Signing in: the login uses your Racing API username and password (the same HTTP Basic auth credentials as the REST API — there are no separate API keys). If you change plan or add a regional add-on, it is picked up on your next fresh sign-in.

If you need to sign in again: open the Command Palette, run Authentication: Remove Dynamic Authentication Providers and remove the entry for mcp.theracingapi.com, then restart the server from MCP: List Servers to trigger a new browser login.