Skip to content
Back to search

qanat

An MCP server for quant factor processing and backtesting. Connect it to your agent and ask.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/fidetolabs/qanat with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/fidetolabs/qanat'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fidetolabs--qanat/badge.svg)](/listings/fidetolabs--qanat)

HTML

<a href="/listings/fidetolabs--qanat"><img src="/api/listings/fidetolabs--qanat/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Python 3.10 or newer.

uv tool install qanat-fdtl                 # or: pip install qanat-fdtl
qanat init my-alpha --demo && cd my-alpha

`--demo` builds four strategies and prices them in about fifteen seconds, so there is something real to look at. The data is synthetic, so it needs no key and no network. Leave it off for an empty project.

Qanat makes no network calls of its own. The only ones are what your sources do.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 122 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="https://raw.githubusercontent.com/fidetolabs/qanat/main/assets/hero.jpg" alt="A qanat cut open: shaft mouths and fields on the surface, the tunnel running beneath them, and a man walking it" width="560">
  3. </p>
  4. <h1 align="center">Qanat</h1>
  5. <p align="center">
  6. <i>A data platform for processing metrics from filings.</i>
  7. </p>
  8. <p align="center">
  9. <a href="https://github.com/fidetolabs/qanat/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-a2e65d?style=flat-square"></a>
  10. <a href="https://github.com/fidetolabs/qanat/blob/main/pyproject.toml"><img alt="Python" src="https://img.shields.io/badge/python-3.10%2B-a2e65d?style=flat-square"></a>
  11. <a href="#the-limits"><img alt="Status" src="https://img.shields.io/badge/status-beta-e8c069?style=flat-square"></a>
  12. <a href="https://discord.gg/JUmwATScS8"><img alt="Discord members" src="https://img.shields.io/badge/dynamic/json?logo=discord&logoColor=white&label=Discord&query=%24.approximate_member_count&url=https%3A%2F%2Fdiscord.com%2Fapi%2Fv10%2Finvites%2FJUmwATScS8%3Fwith_counts%3Dtrue&color=5865F2&style=flat-square"></a>
  13. </p>
  14. ## Why FidetoLabs built this
  15. You are thinking about buying a company. You go and read about it. There are
  16. posts explaining why it is going up, a video from someone who sounds like they
  17. know, charts, and a summary of last quarter that reads like a professional
  18. wrote it.
  19. Any of that now takes a minute to make and costs nothing. Some of it is wrong,
  20. and you cannot tell which.
  21. The filing is still on EDGAR. It still says what the company told its
  22. regulator, and reading it takes as long as it always did.
  23. **FidetoLabs cannot make lying expensive again. It can make checking cheap.**
  24. Qanat is the first tool for that: whatever number it gives you, it can show
  25. you the filing the number came out of and the day that filing was published.
  26. **You write the logic and Qanat runs the calculator.** The formula, the
  27. threshold and the list of companies are yours. It tells you what came out and
  28. never tells you what to do about it.
  29. ## What Qanat is
  30. Qanat reads company filings, computes the metrics you define, and answers **as
  31. of any past date.**
  32. A company publishes its results weeks or months after the period they cover, so
  33. every number here carries two dates: that period, and the day it became
  34. public. Ask about March 2022 and you get what was public in March 2022, not
  35. what we know now.
  36. Your agent is the interface.
  37. **Not investment advice.** What you do with the number is your decision and
  38. your risk.
  39. ## Getting started
  40. ```bash
  41. uv tool install qanat-fdtl # or: pip install qanat-fdtl
  42. export SEC_USER_AGENT="your name you@example.com"
  43. qanat init my-research --demo && cd my-research
  44. claude mcp add qanat -- qanat mcp --scope research
  45. ```
  46. The demo pulls a few real 10-K filings from EDGAR and reads the numbers out of
  47. them, in under a minute. No API key and no account: the SEC only wants a
  48. contact address. Any MCP client works, with `qanat mcp` as the command and the
  49. project folder as its working directory.
  50. ## Using it
  51. Ask your agent. It can find filings on EDGAR, pull the ones you choose, define
  52. a metric as a formula, and screen on it as of a date or across a window.
  53. > *"What data is in here, and where did it come from?"*
  54. >
  55. > *"Pull Apple and Microsoft's last five annual reports."*
  56. >
  57. > *"Define net margin, then show me who passed it in 2022 and what they did
  58. > next."*
  59. **`--scope` decides how much it can do.** Four levels, each including the one
  60. before: `data` reads what is already there, `research` adds finding filings and
  61. screening, `full` adds ingesting and running, `authoring` adds defining metrics
  62. and changing the pipeline. Pick the smallest that does your job.
  63. `full` is the default, and `authoring` sits above it so an agent screening
  64. filings cannot rewire the pipeline by accident.
  65. [`examples/sec-10k`](https://github.com/fidetolabs/qanat/tree/main/examples/sec-10k)
  66. is a corpus of real filings to try it on.
  67. [docs/dataflow.md](https://github.com/fidetolabs/qanat/blob/main/docs/dataflow.md)
  68. walks the pipeline end to end,
  69. [docs/agents.md](https://github.com/fidetolabs/qanat/blob/main/docs/agents.md)
  70. is the tool surface, and
  71. [docs/flows.md](https://github.com/fidetolabs/qanat/blob/main/docs/flows.md),
  72. [docs/contract.md](https://github.com/fidetolabs/qanat/blob/main/docs/contract.md)
  73. and
  74. [docs/words.md](https://github.com/fidetolabs/qanat/blob/main/docs/words.md)
  75. cover why each tool exists, the pipeline rules and the vocabulary.
  76. ## The limits
  77. **It is beta.** It works for my own use and few other people have run it. If
  78. something breaks, open an [issue](https://github.com/fidetolabs/qanat/issues)
  79. or say so on [Discord](https://discord.gg/JUmwATScS8).
  80. **It cannot place an order,** and no agent it serves ever will.
  81. **Nothing is added up.** No average across years, no equity curve. That needs a
  82. decision about how much of each company to hold, and the decision is yours.
  83. **The dates protect a transform, not you.** It cannot see past its date; you
  84. and your agent can, while you are deciding what to try.
  85. **Two sources:** SEC EDGAR for filings and Yahoo Finance for prices. Only the
  86. 10-K and the 10-Q are parsed; other forms are found and labelled, not read.
  87. **For general pipelines, use something else.** Airflow, Dagster and Prefect run
  88. any DAG across many machines. Qanat runs one shape.
  89. Pull requests welcome. See
  90. [CONTRIBUTING.md](https://github.com/fidetolabs/qanat/blob/main/CONTRIBUTING.md).
  91. MIT licensed. Copyright (c) 2026 fidetolabs.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.