For agents
The MCP server
PatternsRadar exposes a Model Context Protocol server at https://api.patternsradar.com/mcp. Connect it to Claude Code, Codex or any MCP client and the agent can screen 3,500+ NSE stocks, replay any scan’s hit rate over 250 sessions, and read 30 years of split-adjusted daily history — including delivery percentage. It does not need to be taught the query language: one tool hands it the whole reference.
What an agent can do with it#
Once connected, these are ordinary prompts:
- “Find NSE stocks above their 200-day average where delivery percentage has been over 60% for a week.”
- “Backtest that scan — what did its matches do over the next 5 days?”
- “How has RELIANCE's delivery percentage trended this month?”
- “Save the ones that work to my account and alert me after each close.”
Setup#
Create a free API key in your account — keys authenticate both the REST API and MCP, on every plan.
claude mcp add --transport http patternsradar \
https://api.patternsradar.com/mcp \
--header "Authorization: Bearer prdr_YOUR_KEY"Tools#
Ten tools, registered with the descriptions below — what a connected model reads is what this table says.
| Tool | What it does |
|---|---|
| run_scan | Run a Sift screener query against NSE equities and return the matches. Call sift_reference first if unsure of the syntax. |
| hitrate | Replay a Sift query across past sessions and report what its matches did over user-chosen forward horizons: win rate, payoff, excess return vs an index, a monthly breakdown and an equity-curve approximation. A sketch, not a backtest: no costs or slippage, and everything it reports describes past matches, never a prediction. |
| search_symbols | Find NSE symbols by ticker or company name. |
| get_symbol | Identity and latest session for one NSE symbol: name, ISIN, listing dates, liquidity tier, last close and average delivery percentage. |
| get_bars | Recent OHLCV bars for one symbol, most recent last. |
| market_meta | What the market database covers: first and last session, row counts, and how many symbols. Call this to find out how fresh the data is. |
| list_saved_scans | List the scans saved to the authenticated account. |
| save_scan | Save a Sift query to the account. Saving under a name that already exists replaces that scan rather than creating a second one. |
| delete_scan | Delete a saved scan by name. |
| sift_reference | The Sift query language: every field, indicator, window, operator and pattern that can appear in a scan. Read this before writing a query. |
Full parameter and return-shape documentation is in the API & MCP reference.
Common questions#
What is the PatternsRadar MCP server?
A Model Context Protocol endpoint that gives AI agents — Claude Code, Codex, or anything speaking MCP over HTTP — direct access to NSE end-of-day data: running Sift screener scans, replaying their historical hit rate, and reading price, volume and delivery data for 3,500+ instruments.
Is the MCP server free to use?
Yes. API keys are free on every plan, including Free, and the MCP endpoint is metered by the same per-plan rate limits as the REST API. Paid plans raise the limits; they do not gate the capability.
Does the agent need to know the Sift query language?
No. The sift_reference tool returns the complete machine-readable language reference — fields, indicators, operators, patterns, examples — generated from the same catalog the compiler reads. An agent calls it once and writes valid scans from then on.
Is the data real-time?
No — end-of-day only, by design. The dataset updates once per session after the NSE close. There is no intraday feed, so an agent asking mid-session sees the previous close.