// getting_started

Connect with MCP

Use TickerDB tools directly from Claude, ChatGPT, Cursor, or another MCP client.

TickerDB provides a hosted remote MCP server. You only need the server URL; supported clients discover the tools and start the OAuth authorization flow automatically.

Server URL

Streamable HTTP

https://mcp.tickerdb.com/mcp

Authentication is built in

Add the URL without an API key or custom headers. Your MCP client opens TickerDB's OAuth authorization page, where you approve the connection. The client stores and refreshes its OAuth credentials after authorization.

Client	Best setup path
Any MCP client	Remote Streamable HTTP URL
Claude	Custom connector
Claude Code	`claude mcp add`
ChatGPT	Plugin
Cursor	`mcp.json` remote server

Any MCP-compatible client

Select Streamable HTTP or remote HTTP as the transport and use the server URL above. Streamable HTTP is the current MCP transport for hosted servers; do not select legacy SSE.

If your client accepts the common mcpServers configuration shape, use:

MCP configuration

// Use this shape in clients that accept mcpServers configuration
{
  "mcpServers": {
    "tickerdb": {
      "url": "https://mcp.tickerdb.com/mcp"
    }
  }
}

Save the configuration, enable TickerDB, and complete the browser authorization prompt. Client menus differ, but no local process or package is required.

Claude web and Desktop

Open Settings → Connectors in Claude.
Click +, then choose Add custom connector.
Name the connector TickerDB and enter https://mcp.tickerdb.com/mcp.
Click Add, then Connect.
Approve the connection on the TickerDB authorization page.
In a conversation, use + → Connectors to enable TickerDB.

Team and Enterprise

An Owner or Primary Owner must first add TickerDB under Organization settings → Connectors. Members can then connect their own TickerDB account.

Claude's remote connector documentation →

Claude Code

Add the hosted server at user scope so it is available across projects:

Terminal

# Add TickerDB for every Claude Code project
claude mcp add --transport http --scope user tickerdb https://mcp.tickerdb.com/mcp

# Confirm the server was added
claude mcp list

Then run /mcp inside Claude Code, select TickerDB, and follow the browser authorization flow. Claude Code stores and refreshes the resulting OAuth credentials.

Claude Code MCP documentation →

ChatGPT

Open Plugins in ChatGPT.
Click + in the top right.
Enter https://mcp.tickerdb.com/mcp as the server URL.
Click Create.
Approve the connection on the TickerDB authorization page.

ChatGPT Plugins documentation →

Cursor

Add TickerDB to a project with .cursor/mcp.json, or make it available everywhere with ~/.cursor/mcp.json:

.cursor/mcp.json

{
  "mcpServers": {
    "tickerdb": {
      "url": "https://mcp.tickerdb.com/mcp"
    }
  }
}

Save the file and open Cursor Settings → Tools & Integrations.
Find TickerDB in the MCP server list and complete the OAuth connection when prompted.
Enable the TickerDB tools you want Cursor Agent to use.

Cursor Agent CLI users can start the same OAuth flow with cursor-agent mcp login tickerdb.

Cursor MCP documentation →

Test the connection

After connecting, try one of these prompts:

Show me oversold large-cap stocks that are near support.
Compare AAPL's daily and weekly trend state.
What changed on my TickerDB watchlist?
Which fields can I use to screen for bullish trend setups?

Troubleshooting

Problem	What to check
Server is not discovered	Use the full URL `https://mcp.tickerdb.com/mcp` and select Streamable HTTP.
Authorization fails	Make sure you have a TickerDB account, then retry the OAuth authorization flow.
Tools disappeared	Disconnect TickerDB in the client, reconnect it, and refresh or rescan the available tools.
Cursor is disconnected	Check the MCP server status in Settings or run `cursor-agent mcp login tickerdb`.

The TickerDB endpoint uses the MCP Streamable HTTP transport and OAuth. You do not need to run a local TickerDB MCP process when using the hosted URL.