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/mcpTransport 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
ChatGPT
Open ChatGPT pluginsOpens the Plugins screen, renamed from Connectors in July 2026.
- Turn on developer mode under Settings → Security and login.
- Open Plugins, then press the plus button.
- Name it Ticker, add a description, and paste the URL above under Connection.
- Set authentication to OAuth, then sign in to Ticker when asked.
Needs a paid ChatGPT plan (Plus, Pro, Business, Enterprise or Edu).
Full ChatGPT walkthroughClaude (desktop / web)
Add to ClaudeOpens the Add custom connector dialog, for claude.ai and the desktop app.
- Open Customize → Connectors, then Add → Add custom connector.
- Name it Ticker, paste the URL above, then Continue.
- Click Connect, then approve access on Ticker's page.
- In a chat, open + → Connectors and switch Ticker on.
Claude Free holds one custom connector; Pro and Max hold more. On Team and Enterprise an owner adds it first.
Full Claude walkthroughPerplexity
Open Perplexity connectorsOpens the Connectors screen under All settings.
- Open your profile → All settings → Connectors.
- Click Custom connector, then choose Remote.
- Name it Ticker and paste the URL above.
- Set authentication to OAuth and transport to Streamable HTTP, then Add.
- Click the connector card to sign in to Ticker and switch it on.
Needs a paid Perplexity plan (Pro, Max or Enterprise).
Full Perplexity walkthroughCursor
Add to CursorOpens 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 walkthroughClaude Code
claude mcp add --transport http ticker https://api.findticker.com/mcpThen run claude mcp login ticker (or /mcp inside Claude Code) and sign in over OAuth.
Full Claude Code walkthroughCodex CLI
codex mcp add ticker --url https://api.findticker.com/mcpThen run codex mcp login ticker to sign in over OAuth.
VS Code (Copilot)
Add to VS CodeOpens 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/mcpRestart 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_columnsWhat is happening with the Oasis show at MetLife? Show me the price history and how demand has moved.
search_eventsget_event_analyticsget_event_price_chartChart how Sabrina Carpenter's popularity rank has moved over the last three months.
get_performer_analyticsget_performer_rank_chartSave that screen as a view called Cheap and tightening, then show me what it has matched so far.
create_viewlist_viewslist_matchesWatch the three cheapest of those events and alert me when the median price falls another 10 percent.
watch_eventupdate_watchlist_watchlistWhy did prices for that show move? Check the news and social coverage.
research_eventTool reference (46 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_eventsFilter every tracked event by price, demand, velocity, rank, and 100+ other signals.
readsearch_eventsFind events by name, date window, venue, performer, or on-sale date.
readget_event_analyticsThe full analytics snapshot for one event: prices, inventory, demand, peer-relative ranks.
readget_performer_analyticsA performer's signals: social momentum, popularity ranks, average price trends.
readget_event_price_chartDaily price and inventory history for an event, with a rendered chart.
readget_event_demand_chartDaily demand history (interest and sales) with a rendered chart.
readget_performer_rank_chartDaily marketplace popularity-rank history for a performer, with a rendered chart.
readget_event_analytics_historyWhat any signal read on any past day, for checking how a signal behaved over time.
readfind_venueTurn a building's name into its Ticker venue id, with city, state and how many events it holds.
readget_venue_scheduleWhat is on at one venue inside a forward window, soonest first.
readlist_screen_columnsEvery column usable in a screen, with semantics and units.
readViews & alertsSaved screens that watch the market and alert you on matches.
list_viewsYour saved Views, with live membership and recent match counts.
readcreate_viewSave a screen as a View that fires alerts when events match.
writeupdate_viewRename, re-scope, pause, or re-route an existing View.
writedelete_viewPermanently remove a View and its match history.
writelist_matchesThe feed of which events entered which Views, and why.
readget_matchOne match in full, with the analytics snapshot frozen at firing time.
readget_view_alert_previewA dry run: what the last 24 hours of this View would have sent under its current settings. Nothing is sent.
readlist_view_targetsWhere this View delivers besides email, and how often each one gets a batch.
readset_view_targetSend this View's matches to a destination, and set how often. Repeating it changes the cadence.
writeremove_view_targetStop delivering this View to one destination. The destination itself stays.
writeAlert destinationsWhere alerts deliver besides email: Slack and Discord channels.
list_destinationsYour delivery channels and how many alerts use each.
readcreate_destinationAdd a Slack or Discord channel; a live test message verifies it works.
writewebupdate_destinationRename, pause, or resume a delivery channel.
writewebdelete_destinationRemove a channel; its alerts fall back to email.
writeWatchlistSingle events you follow, with their own alert settings.
list_watchlistThe events you follow, with the alert settings on each.
readwatch_eventFollow one event and get alerts when its price or demand moves.
writeupdate_watchChange the thresholds or the cadence on an event you follow.
writeunwatch_eventStop following an event and stop its alerts.
writeget_watch_defaultsThe default thresholds a new watch starts from.
readset_watch_defaultsChange the thresholds every new watch starts from. Existing watches keep theirs.
writelist_watch_triggersEvery trigger a watch can fire on, with its parameters and supported range.
readSections and seatsInside one event: what is open by section, the seats behind it, and who is holding the inventory.
get_event_sectionsWhat is open in each section of one event, with its price band.
readget_event_sections_liveThe newest observed count per section, as of the last collection pass.
readget_event_ga_historyEach general admission section's open count over time, with its peak and its last change.
readget_event_sections_atWhat every section looked like at one moment in the past.
readget_event_section_seriesHow one section's open count moved over time, one point per collection pass.
readget_event_seats_liveThe individual seats currently open, row and number, for a seat map.
readget_event_seats_recentWhich seats were taken or released most recently, newest first.
readget_event_seat_historyEvery state one seat has been observed in, so you can see when it went.
readget_event_sale_windowsThe stretches when inventory actually moved, rather than a flat daily average.
readget_event_seller_concentrationHow much of an event's inventory sits with the largest holders.
readget_event_seller_seriesHow that concentration moved over time.
readget_event_workspaceWhat you last had selected on this event's section map, so a session can pick the view back up.
readResearchThe context behind a move: news and social coverage, cited.
research_eventCited news and social context explaining why an event is moving.
readwebYour accountYour plan and what is left of it.
get_accountYour plan, when it renews, and each allowance with what you have used and what is left.
readTroubleshooting
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.