Skip to content

Developer docs

Ticker MCP server

Ticker exposes its live-event ticket market data (prices, demand, screening, alerts, and event research) as a hosted MCP server. Any MCP client (Claude, ChatGPT, Cursor, Perplexity, and others) can query it with your Ticker account.

Getting started

Add the server URL to your client, then sign in with your Ticker account when the browser window opens. There are no API keys to create, copy, or store.

https://api.findticker.com/mcp

Transport is Streamable HTTP. Per-client setup is under Clients. Using the server requires a Ticker account. Create one here; what each plan includes is on the plans page.

Authentication

The server uses OAuth 2.1 with PKCE. The first time your client connects it discovers the authorization server, opens findticker.com in your browser to sign in and approve access, and receives short-lived tokens it refreshes on its own.

Revoke access anytime by signing out of the connection in your client, or from your Ticker account settings.

Step-by-step guides

Clients

Opens the Plugins screen, renamed from Connectors in July 2026.

  1. Turn on developer mode under Settings → Security and login.
  2. Open Plugins, then press the plus button.
  3. Name it Ticker, add a description, and paste the URL above under Connection.
  4. Set authentication to OAuth, then sign in to Ticker when asked.

Needs a paid ChatGPT plan.

Full ChatGPT walkthrough

Claude (desktop / web)

Add to Claude

Opens the Add custom connector dialog, for claude.ai and the desktop app.

  1. Open Customize → Connectors, then Add → Add custom connector.
  2. Name it Ticker, paste the URL above, then Continue.
  3. Click Connect, then approve access on Ticker's page.
  4. Enable Ticker under the tools menu in a chat.

Needs Claude Pro or Max. On Team and Enterprise an owner adds it first.

Full Claude walkthrough

Opens the Connectors screen under All settings.

  1. Open your profile → All settings → Connectors.
  2. Click Custom connector, then choose Remote.
  3. Name it Ticker and paste the URL above.
  4. Set authentication to OAuth and transport to Streamable HTTP, then Add.
  5. Click the connector card to sign in to Ticker and switch it on.

Needs a paid Perplexity plan.

Full Perplexity walkthrough

Opens Cursor with the Ticker server filled in. Sign in over OAuth when prompted.

{ "mcpServers": { "ticker": { "url": "https://api.findticker.com/mcp" } } }

Add under mcpServers in ~/.cursor/mcp.json (or Settings → MCP → Add), then approve OAuth.

Full Cursor walkthrough

Claude Code

claude mcp add --transport http ticker https://api.findticker.com/mcp

Then run /mcp inside Claude Code and sign in over OAuth.

Codex CLI

codex mcp add ticker --url https://api.findticker.com/mcp

Then run codex mcp login ticker to sign in over OAuth.

VS Code (Copilot)

Add to VS Code

Opens VS Code and adds the Ticker server. Sign in over OAuth when prompted.

code --add-mcp "{\"name\":\"ticker\",\"type\":\"http\",\"url\":\"https://api.findticker.com/mcp\"}"

Adds the server from the terminal instead; sign in over OAuth when prompted.

Gemini CLI

gemini mcp add --transport http ticker https://api.findticker.com/mcp

Restart the Gemini CLI, then authorize when prompted.

Example prompts

Find NBA games in the next 30 days where resale prices dropped more than 20 percent this week but inventory is still tight.

screen_eventslist_screen_columns

What is happening with the Oasis show at MetLife? Show me the price history and how demand has moved.

search_eventsget_event_analyticsget_event_price_chart

Chart how Sabrina Carpenter's popularity rank has moved over the last three months.

get_performer_analyticsget_performer_rank_chart

Save that screen as a view called Cheap and tightening, then show me what it has matched so far.

create_viewlist_viewslist_matches

Watch the three cheapest of those events and alert me when the median price falls another 10 percent.

watch_eventupdate_watchlist_watchlist

Why did prices for that show move? Check the news and social coverage.

research_event

Tool reference (25 tools)

read tools only query your data. write tools change something you own; your client will usually ask before running them. web tools reach beyond Ticker's own data.

Market dataScreen, search, and chart the live event universe.

screen_events

Filter every tracked event by price, demand, velocity, rank, and 100+ other signals.

read
search_events

Find events by name, date window, venue, performer, or on-sale date.

read
get_event_analytics

The full analytics snapshot for one event: prices, inventory, demand, peer-relative ranks.

read
get_performer_analytics

A performer's signals: social momentum, popularity ranks, average price trends.

read
get_event_price_chart

Daily price and inventory history for an event, with a rendered chart.

read
get_event_demand_chart

Daily demand history (interest and sales) with a rendered chart.

read
get_performer_rank_chart

Daily marketplace popularity-rank history for a performer, with a rendered chart.

read
get_event_analytics_history

What any signal read on any past day, for checking how a signal behaved over time.

read
list_screen_columns

Every column usable in a screen, with semantics and units.

read

Views & alertsSaved screens that watch the market and alert you on matches.

list_views

Your saved Views, with live membership and recent match counts.

read
create_view

Save a screen as a View that fires alerts when events match.

write
update_view

Rename, re-scope, pause, or re-route an existing View.

write
delete_view

Permanently remove a View and its match history.

write
list_matches

The feed of which events entered which Views, and why.

read
get_match

One match in full, with the analytics snapshot frozen at firing time.

read

Alert destinationsWhere alerts deliver besides email: Slack and Discord channels.

list_destinations

Your delivery channels and how many alerts use each.

read
create_destination

Add a Slack or Discord channel; a live test message verifies it works.

writeweb
update_destination

Rename, pause, or resume a delivery channel.

writeweb
delete_destination

Remove a channel; its alerts fall back to email.

write

WatchlistSingle events you follow, with their own alert settings.

list_watchlist

The events you follow, with the alert settings on each.

read
watch_event

Follow one event and get alerts when its price or demand moves.

write
update_watch

Change the thresholds or the cadence on an event you follow.

write
unwatch_event

Stop following an event and stop its alerts.

write
get_watch_defaults

The default thresholds a new watch starts from.

read

ResearchThe context behind a move: news and social coverage, cited.

research_event

Cited news and social context explaining why an event is moving.

readweb

Troubleshooting

The client never asks me to sign in

Remove the server and add it again, checking the URL is exactly the one above. The sign-in prompt comes from the client the first time it connects.

“The access token is invalid or expired”

Your client normally refreshes tokens on its own. If the error persists, disconnect and reconnect the server to sign in again.

“Payment required” or “insufficient tier” when calling tools

Your account doesn't currently include agent access. See what each plan includes on the plans page, then reconnect.

“Daily MCP request limit reached”

Request quotas reset daily (UTC). Discovery calls like list_screen_columns don't count against them.

Connected, but tools are missing from the client's list

Some clients cache the tool list. Reconnect the server (or restart the client) to refresh it.

Security contact

Connections are authorized per user over OAuth 2.1 (PKCE required); access tokens are short-lived and refresh tokens rotate on use. The server only ever sees your Ticker data: no marketplace accounts, no payment credentials.

Found a vulnerability? Email alim@findticker.com with reproduction steps. We read every report.