Filtrix MCP Server
MCP (Model Context Protocol) server that gives AI assistants access to Filtrix — a historical trading pattern discovery engine with 348K+ records and 255 filters spanning 5 years of data.
What can it do?
| Tool | Description |
|---|---|
run_backtest |
Run a historical backtest with filters. Returns sample size, win rate, average move, percentiles. |
screen_tickers |
Find matching historical events. Returns date, symbol, price, gap, volume. |
get_ticker_info |
Get ticker metadata: company name, sector, market cap, exchange, employees. |
list_filters |
Discover all 255 available filter columns (gap, price, float, volume, etc.). |
Quick Start
1. Get an API key
Sign up at filtrix.net, then generate an API key in your account settings.
2. Configure Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"filtrix": {
"command": "uvx",
"args": ["filtrix-mcp"],
"env": {
"FILTRIX_API_KEY": "flt_your_key_here"
}
}
}
}
Config file location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
3. Restart Claude Desktop
The Filtrix tools will appear automatically.
Usage Examples
Once configured, ask Claude things like:
- "What happens historically when a stock gaps up 30% with a float under 10M shares?"
- "Show me the last 20 stocks that gapped up over 50%"
- "Look up NVDA ticker info"
- "What filters are available for backtesting?"
Alternative: pip install
pip install filtrix-mcp
Then run manually:
export FILTRIX_API_KEY="flt_your_key_here"
filtrix-mcp
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
FILTRIX_API_KEY |
Yes | — | Your Filtrix API key (starts with flt_) |
FILTRIX_BASE_URL |
No | https://filtrix.net |
API base URL |
Rate Limits
| Tier | Daily Limit |
|---|---|
| Free | 50 requests |
| Pro | 1,000 requests |
Limits reset at midnight ET.
Requirements
- Python 3.10+
- Active Filtrix account with API key
Metadata
Release files for filtrix-mcp 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| filtrix_mcp-0.1.2.tar.gz | 4.9 kB | Without provenance | Details for filtrix_mcp-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| filtrix_mcp-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for filtrix_mcp-0.1.2-py3-none-any.whl |
Total release size: 11.4 kB
Release files / filtrix_mcp-0.1.2.tar.gz
| Download URL | filtrix_mcp-0.1.2.tar.gz |
|---|---|
| Size | 4.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4d6872d3cb71f9935107a3ed7bbc341081c58053379504efc57d979c58d481ab
|
|
BLAKE2b-256 checksum How to use checksums |
9e785e736545c37cf8fbac601a507e0846f833ef17ec94bf608c67fd650c663e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.11
|
Release files / filtrix_mcp-0.1.2-py3-none-any.whl
| Download URL | filtrix_mcp-0.1.2-py3-none-any.whl |
|---|---|
| Size | 6.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1e7aae85d96fee98201ed144db365958247dae5ff1bee32152f79b22c1e2aa9a
|
|
BLAKE2b-256 checksum How to use checksums |
4128ff950fb8103703f4bb154605279d112109809889051e42fd68f5298c48e5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.11
|
Security for filtrix-mcp 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.