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.

Clients

Claude Code

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

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

Cursor

Add to Cursor

Opens Cursor and adds the Ticker server. Approve 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.

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.

Claude (desktop / web)

Open Claude connectors

Takes you straight to Settings → Connectors, for claude.ai and the desktop app.

Choose Add custom connector, paste the URL above, name it ticker, and approve access over OAuth.

ChatGPT

Settings → Connectors → Add. Paste the URL above and connect over OAuth. Available on ChatGPT Plus, Pro, and Enterprise.

Perplexity

Settings → Connectors → Add connector. Paste the URL above and authorize over OAuth.

Tool reference (20 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, revenue 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 — shopper attention and sales pace — with a rendered chart.

read

get_performer_rank_chart

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

read

get_event_analytics_history

What any signal read on any past day — the backtesting primitive.

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

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

research_event

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

readweb

Perplexity (custom connector)

Perplexity supports custom MCP connectors on its Pro, Max, and Enterprise plans:

Open Settings → Connectors → Add connector and choose the custom option.
Name it ticker, paste the server URL above, and keep the transport on Streamable HTTP with OAuth 2.0 auth.
Save, then authorize in the browser window that opens. Enterprise admins can share the connector org-wide.

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.