Skip to main content

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)

Source distribution for filtrix-mcp 0.1.2
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)

Table of built distributions (wheels) for filtrix-mcp 0.1.2
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page