io.github.Tickets-dot-dev/ai

Official registry E-commerce

Live ticket prices, listings and seat maps for AI agents.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code
claude mcp add --transport http ai 'https://api.tickets.dev/mcp' --header 'Authorization: <Bearer followed by your Tickets.dev API key, from https://tickets.dev/pricing. Optional: clients that support OAuth can sign in at tickets.dev instead.>'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "ai": {
            "type": "http",
            "url": "https://api.tickets.dev/mcp",
            "headers": {
                "Authorization": "<Bearer followed by your Tickets.dev API key, from https://tickets.dev/pricing. Optional: clients that support OAuth can sign in at tickets.dev instead.>"
            }
        }
    }
}
NPM package tickets-dev-mcp
Claude Code
claude mcp add ai -e 'TICKETS_DEV_KEY=<your tickets_dev_key>' -- npx -y tickets-dev-mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "ai": {
            "command": "npx",
            "args": [
                "-y",
                "tickets-dev-mcp@0.1.0"
            ],
            "env": {
                "TICKETS_DEV_KEY": "<your tickets_dev_key>"
            }
        }
    }
}

Environment variables

  • TICKETS_DEV_KEY required secret Your Tickets.dev API key, from https://tickets.dev/pricing

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Tickets.dev AI
  2. What you can ask
  3. Use the API with any agent
  4. Agent skill
  5. Plugins
  6. MCP server
  7. API key
  8. More from Tickets.dev
  9. Development
  10. License

Tickets.dev AI

This repo is the home for using Tickets.dev with AI agents. Tickets.dev returns live ticket listings, all-in prices and seat maps from Ticketmaster, StubHub, SeatGeek, Vivid Seats, TickPick, Gametime, Viagogo and more, in one schema.

Tickets.dev is a standard HTTP API, so any agent that can make web requests can use it. This repo adds an agent skill, plugins for popular agent tools, and how to connect the hosted MCP server.

What you can ask

I have 2 seats in section 110, row 36 for the Eagles at Sphere. What are the same and nearby seats listed for on each marketplace?

Show the seat map for this StubHub event with the cheapest all-in price in each section.

How many tickets are listed for each Sphere show next month, and what's the get-in price?

Write a script that saves the listed tickets and get-in price for these events every morning.

Use the API with any agent

Give your agent the OpenAPI spec, the agent docs and your API key. Get a key at tickets.dev and send it in the x-api-key header.

Most tasks take two calls. Find the event, then capture one marketplace page:

curl "https://api.tickets.dev/v1/events?query=eagles%20sphere" \
  -H "x-api-key: $TICKETS_DEV_KEY"

curl -G "https://api.tickets.dev/v1/capture" \
  --data-urlencode "url=https://www.ticketmaster.com/eagles-live-at-sphere-las-vegas-nevada-12-11-2026/event/17006483D6FAFC60" \
  -H "x-api-key: $TICKETS_DEV_KEY"

Agent skill

The tickets-dev skill covers the details of ticket data that agents tend to get wrong, such as all-in prices, sellable quantities, and why a listing that disappears isn't proof of a sale. It's plain Markdown, so you can add it to any agent's instructions.

Plugins

If you use one of these agent tools, we recommend installing the Tickets.dev plugin. It includes the skill and tools your agent can call directly. The first time the tools are used, you sign in at tickets.dev and approve the connection, so there's no API key to copy.

Claude Code

Run these commands in Claude Code:

/plugin marketplace add Tickets-dot-dev/ai
/plugin install tickets-dev@tickets-dev

Then run /mcp, pick tickets-dev and choose Authenticate to sign in.

Codex

Run this command:

codex plugin marketplace add Tickets-dot-dev/ai

Then restart Codex, install Tickets.dev from the Plugins directory, and sign in:

codex mcp login tickets-dev
Cursor

Install the plugin from cursor.directory, or use the MCP server.

Gemini CLI

Run this command:

gemini extensions install https://github.com/Tickets-dot-dev/ai

Then run /mcp auth tickets-dev in Gemini CLI to sign in.

Grok Build

The plugin is coming to the Grok Build marketplace. Until then, use the MCP server.

MCP server

The tools are hosted at https://api.tickets.dev/mcp (Streamable HTTP).

Add that URL and sign in. You'll be sent to Tickets.dev to sign in and approve the connection, which creates an API key for that app. Disconnect it any time from your account settings.

In Claude Code:

claude mcp add --transport http tickets-dev https://api.tickets.dev/mcp

Then run /mcp, pick tickets-dev and choose Authenticate.

In Claude or ChatGPT, add it as a custom connector with the same URL.

In clients that take a URL, for example .cursor/mcp.json:

{
  "mcpServers": {
    "tickets-dev": {
      "url": "https://api.tickets.dev/mcp"
    }
  }
}

For scripts and clients that can't sign in, send an API key as a header instead, for example "headers": { "Authorization": "Bearer tk_live_..." }, or in Claude Code --header "Authorization: Bearer $TICKETS_DEV_KEY".

Clients that only start local servers, such as Claude Desktop's claude_desktop_config.json, can run the tickets-dev-mcp package. It's a small bridge that forwards to the same hosted server:

{
  "mcpServers": {
    "tickets-dev": {
      "command": "npx",
      "args": ["-y", "tickets-dev-mcp"],
      "env": { "TICKETS_DEV_KEY": "tk_live_..." }
    }
  }
}
ToolWhat it does
find_eventsFinds upcoming events and their URL on every marketplace. Free.
get_listingsReturns every listing on one event page, with all-in prices.
compare_pricesRanks one event's listings across marketplaces by all-in price.
get_seat_mapReturns the section and seat maps, the cheapest price per section and, where the map gives it, venue capacity.
list_marketplacesLists supported marketplaces. Free.

The tools only read data. They can't buy, hold or list tickets.

API key

You only need a key for the HTTP API, scripts, and clients that can't sign in. The tickets-dev-mcp package and the skill's direct API calls read it from the TICKETS_DEV_KEY environment variable:

export TICKETS_DEV_KEY=tk_live_...

Restart your agent after setting it. Don't paste your key into a chat. If the key is missing, the agent tells you how to add it.

Each capture of one event on one marketplace is billed, the same as a direct API call. One tool call uses at most 15 captures, and up to 3 tool calls can run at once per account. See pricing.

More from Tickets.dev

Development

npm install
node --test                                  # offline tests
TICKETS_DEV_E2E_KEY=<your key> node --test   # end-to-end through api.tickets.dev/mcp (uses a few captures)

License

MIT. Not affiliated with any ticket marketplace.

Frequently asked questions

What is io.github.Tickets-dot-dev/ai?

Live ticket prices, listings and seat maps for AI agents.

How do I install io.github.Tickets-dot-dev/ai?

It runs as a remote server. In Claude Code: claude mcp add --transport http ai 'https://api.tickets.dev/mcp' --header 'Authorization: <Bearer followed by your Tickets.dev API key, from https://tickets.dev/pricing. Optional: clients that support OAuth can sign in at tickets.dev instead.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Tickets-dot-dev/ai need an API key?

Yes. It expects TICKETS_DEV_KEY, Authorization, which you set in its configuration.

Is io.github.Tickets-dot-dev/ai open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.Tickets-dot-dev/ai?

It is published by Tickets-dot-dev. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.