# scanr.ai API > scanr.ai is a stock scanner for U.S. equities. Its REST API and MCP server run scans (screens across the whole market on price, volume, technical indicators, fundamentals, relative strength and chart patterns), and serve the data behind them: relative strength ranks, chart patterns, supply/demand zones, market themes, peers, ETF holdings and 80+ technical indicators. Every page below is markdown. Start with the Quick Start, then How Scanning Works and Building Scan Payloads: scanning is the core of the API. REST base URL: https://scanr.ai/api/v2. MCP endpoint: https://mcp.scanr.ai. ## Get started - [Introduction](https://api-docs.scanr.ai/index.md): What the scanr.ai API and MCP server do, what you can build with them, and where to start. - [Quick Start](https://api-docs.scanr.ai/quickstart.md): Create a token and run your first stock scan against the scanr.ai API in about two minutes, in cURL, Python or JavaScript. - [Authentication](https://api-docs.scanr.ai/authentication.md): Create a scanr.ai API token and authenticate requests with a Bearer or X-API-Key header. - [Plans & Rate Limits](https://api-docs.scanr.ai/rate-limits.md): What each API plan includes, how requests are counted and limited, the daily AI credit budget, and which endpoints need which plan. - [Errors](https://api-docs.scanr.ai/errors.md): The scanr.ai API's status codes and error bodies, and which ones a client should retry. ## Scanning - [How Scanning Works](https://api-docs.scanr.ai/scanning.md): The scan model: a universe, groups of filters, timeframes, and the list of matching tickers that comes back. - [Building Scan Payloads](https://api-docs.scanr.ai/scan-payloads.md): The scan request body filter by filter: price, volume, indicators, fundamentals, patterns and universe restrictions, with validated examples. - [Natural-Language Scans](https://api-docs.scanr.ai/natural-language-scans.md): Turn a plain-English description into a scan payload, refine it in follow-up sentences, and run it. - [Saved Scans & Performance](https://api-docs.scanr.ai/saved-scans.md): Save a scan so scanr.ai keeps running it, then read its alerts, history and forward-return performance. ## Data - [Datasets](https://api-docs.scanr.ai/datasets.md): Every dataset the scanr.ai API serves: scans, relative strength, chart patterns, supply/demand zones, themes, peers, ETF holdings and technical indicators. - [Coverage & Freshness](https://api-docs.scanr.ai/coverage.md): Which securities scanr.ai covers, where the data comes from, and when each dataset is updated. ## AI & agents - [MCP Server](https://api-docs.scanr.ai/mcp-server.md): Connect Claude, Cursor or any MCP client to scanr.ai's Model Context Protocol server. - [Docs for Agents](https://api-docs.scanr.ai/agents.md): Machine-readable docs for AI agents: llms.txt, markdown pages, the OpenAPI spec and an installable Agent Skill. ## Guides - [Run an End-of-Day Screen](https://api-docs.scanr.ai/guides/end-of-day-screen.md): Run a scan after the close every trading day and export the matches to CSV, in Python and JavaScript. - [Find Relative-Strength Leaders](https://api-docs.scanr.ai/guides/relative-strength-leaders.md): Rank the market by relative strength and combine RS with trend filters to find leading stocks. - [Track Theme Rotation](https://api-docs.scanr.ai/guides/theme-rotation.md): Follow which market themes are gaining strength, then scan inside a theme for its leaders. - [Research a Concept](https://api-docs.scanr.ai/guides/concept-research.md): Ask whether a stock relates to a theme, place, product or event, or which stocks do, and read each cited answer correctly. - [Compute Technical Indicators](https://api-docs.scanr.ai/guides/technical-indicators.md): Compute RSI, moving averages, ATR and 60+ other indicators for any ticker, one at a time or in bulk. - [Measure a Scan's Edge](https://api-docs.scanr.ai/guides/backtest-a-scan.md): Use a saved scan's forward returns and simulated trades to judge whether it actually works. - [Build a Scanning Agent](https://api-docs.scanr.ai/guides/scanning-agent.md): Give an AI agent scanr.ai's scan tools over MCP or REST, with a workflow and prompt that produce reliable screens. ## Reference - [OpenAPI spec](https://api-docs.scanr.ai/openapi.json): OpenAPI 3.1 document for every endpoint an API token can call, with request and response schemas. - [API Reference](https://api-docs.scanr.ai/api): The same spec rendered as an interactive reference. - [Connect an agent](https://api-docs.scanr.ai/connect.md): Step-by-step instructions an agent follows to connect a user to the MCP server or REST API and run a first scan. - [Agent Skill](https://api-docs.scanr.ai/skill.md): An installable SKILL.md that teaches an agent to scan with scanr.ai. - [Full docs](https://api-docs.scanr.ai/llms-full.txt): Every page above inlined into one file. ## Optional - [scanr.ai](https://scanr.ai): The web app. - [Pricing](https://scanr.ai/pricing): Plans, including the API plans. - [API tokens](https://scanr.ai/account/api-tokens): Create and manage tokens.