Sardine MCP server
Lets AI assistants (Claude, ChatGPT, Cursor, coding agents) look up how often Kalshi crypto up/down contracts have settled YES in a given situation: this far from the strike, with this much time left. The numbers come from sardine.info.
These are counts of what happened before, not forecasts or advice. Kalshi's own price is usually the better predictor. Sardine publishes how accurate its own numbers have been, and this server exposes that too.
Tools
| Tool | What it answers |
|---|---|
list_markets |
Which series are covered (BTC/ETH, 15-minute and hourly) and how well calibrated each one is |
get_settlement_rate |
"BTC is $40 below the strike with 7 minutes left. How often has that settled YES?" Returns the rate, a 95% interval and the sample size, plus Kalshi's fee if you pass the ask |
get_live_board |
Contracts open right now, with Kalshi's price beside the historical count |
get_rate_table |
The full lookup table (distance × time left) for one series |
get_track_record |
What Sardine published versus what actually settled |
list_datasets |
Downloadable CSV history (opens in Excel) |
backtest_rule |
"Would this rule have made money?" Replays Sardine's per-second recordings of Kalshi's 15-minute contracts, with Kalshi's real fee, fills only up to the size on the book, a 2-second order delay, and official settlement. Returns results only: profit per contract with a 95% interval, a zero-delay comparison, stability, breakdowns and warnings |
There's also one resource, sardine://method, a plain-English description of
the method.
Install
Claude Code
claude mcp add sardine -- uvx sardine-mcp
Claude Desktop / Cursor (mcpServers in the config file)
{
"mcpServers": {
"sardine": { "command": "uvx", "args": ["sardine-mcp"] }
}
}
Remote (streamable HTTP)
sardine-mcp --http --port 8000 # serves http://127.0.0.1:8000/mcp
# or point any streamable-HTTP client at https://sardine.info/mcp
Not on PyPI yet. Until it is, install from this folder:
pip install -e ., then run sardine-mcp.
With a free key (from https://sardine.info/signup) set as
SARDINE_API_KEY, limits are higher and we can tell you before anything
changes.
REST API and Excel
The same data is served at https://sardine.info/v1/.... Add
format=csv to any endpoint for a file that opens in Excel. See
https://sardine.info/developers and https://sardine.info/v1/openapi.json.
Running the public API yourself
sardine-gateway serves the REST API, the remote MCP endpoint, free keys
and usage metering. See deploy/DEPLOY.md.
Data and credit
Market prices come from Kalshi. Statistics and files are by Sardine (sardine.info). Please credit "Sardine (sardine.info)". No API key is needed during the free preview.
mcp-name: info.sardine/sardine
1 maintainer
Metadata
1 maintainer
Release files for sardine-mcp 0.1.1
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 | |
|---|---|---|---|---|
| sardine_mcp-0.1.1.tar.gz | 44.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sardine_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 79.3 kB
Release files / sardine_mcp-0.1.1.tar.gz
| Download URL | sardine_mcp-0.1.1.tar.gz |
|---|---|
| Size | 44.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a18afa9b418a80305a943c114a327ea802e9bfd00ae998afcc38a14efc70b950
|
|
BLAKE2b-256 checksum How to use checksums |
5818e7a80e14c1be60220932b1f8e0249d24f4cdf1f83322b5c2894411a096d5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.15.0
|
Release files / sardine_mcp-0.1.1-py3-none-any.whl
| Download URL | sardine_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 35.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3fd4f4e86845c0ff030723166d0a639c7d7d4cb9cdb38312e010f392d159e60c
|
|
BLAKE2b-256 checksum How to use checksums |
012ecb00ab3c252e7b0065d941ef1f3066a07b6275da4c93bb05f616ee76ea4f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.15.0
|
Security for sardine-mcp 0.1.1
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.
