Skip to main content

Seiche: funding and FX evidence for Python and AI agents

Research US-dollar funding, money markets, foreign exchange, and capital-market context with source dates, provenance, coverage, and known gaps attached.

Open the hosted terminal · Connect an agent · Read dated research answers

PyPI Python MCP Registry AGPL-3.0-or-later

Seiche is an open-source money-, foreign-exchange, and capital-market evidence terminal, with its deepest live coverage in US-dollar funding. It joins public and official sources from the Federal Reserve, New York Fed, OFR, US Treasury, CFTC, and other authorities into a source-clocked research surface.

Outputs retain their as-of dates, provenance, evidence status, known gaps, and point-in-time eligibility. Use them for financial research, agent context, and reviewable evidence. Seiche does not execute trades or provide real-time quotes or investment advice.

Country funding references are available through money_market_context with section="countries" (catalog) or section="countries", country="JP" (country observations). The REST equivalent is /api/v2/country-funding/JP. Coverage is partial: monthly references, daily curves, shared euro-area policy and national sovereign issuers retain their own identities and dates. See the country methodology.

Connect an AI agent without installing Seiche

Connect an MCP-capable client to the public Streamable HTTP endpoint:

https://api.seiche.info/mcp

For clients that accept mcpServers JSON configuration:

{
  "mcpServers": {
    "seiche": {
      "url": "https://api.seiche.info/mcp"
    }
  }
}

Public evidence tools can be used without an account, subject to service limits. Start with tools/list to discover the tools available to your caller, then use:

Research task MCP tool and arguments
Read the funding-stress conclusion funding_stress_now with {}
Get compact USD funding evidence money_market_context with {"section":"summary"}
Check source freshness and faults data_health with {}
Review a country's funding references money_market_context with {"section":"countries","country":"JP"}
Discover connected evidence products research_network with {}

For example, this anonymous read returns a bounded funding summary:

curl --fail-with-body https://api.seiche.info/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"money_market_context","arguments":{"section":"summary"}}}'

Keep returned dates, coverage, caveats, and unavailable or restricted states in your agent's answer. A successful request does not make every source current. See the MCP integration guide for Claude, Codex, Cursor, VS Code, and raw JSON-RPC examples.

Install the Python package for local research

Seiche requires Python 3.12 or newer. On macOS or Linux:

python3.12 -m venv .venv
.venv/bin/python -m pip install --upgrade seiche
.venv/bin/seiche --help

The package installs the seiche research CLI and seiche-mcp stdio server. To connect an agent to your local installation's public tool surface:

SEICHE_MCP_PUBLIC=1 .venv/bin/seiche-mcp

Local tools use local source and cache state. For an optional local collection and brief:

.venv/bin/seiche pull
.venv/bin/seiche brief

The first pull can be slow while public histories populate the local cache. Later reads reuse the cadence-aware cache; stale and unavailable inputs remain explicit. Local collection depends on upstream availability and source access.

Start the local REST API at http://127.0.0.1:8787 with:

.venv/bin/seiche serve

The PyPI wheel contains the Python backend, not the browser terminal. Use seiche.info for the hosted terminal. To serve a local browser UI, use a source checkout, install the backend there, and build the frontend with npm ci followed by npm run build in frontend/. The source checkout's API serves the resulting frontend/dist directory when it is present.

Connect the product family

Seiche provides funding and macro context. Follow a research question to the product responsible for the next evidence type:

Need Product
Bank disclosures and named-institution evidence LiquiLens
Indicative BTC exit cost and market-depth research Undertow
China and regional public-record research Palimpsest
Saved reviews and Python agent workflows across the family Financial Evidence

Each product retains its own coverage, access rules, source clocks, and data rights. The shared connection guide lists the available hosted MCP endpoints.

Access and evidence boundaries

Eight public research tools are anonymous: source_rights_status, money_market_context, market_workbench, world_markets_context, gift_city_context, gold_inventory_carry, research_network, and data_health. Start with source_rights_status to inspect the release scope. Legacy forecasts, backtests, stress conclusions and Trade Safety context are explicitly unavailable for every caller while their source rights remain unverified. Authentication does not unlock these legacy features.

Authenticated hosted MCP adds five private Agent Room preview tools for identity-to-key binding, room creation, signed append, verified listing, and full-chain verification. The same protected operations have REST twins under /api/agent-room/. They are discussion and evidence primitives only: every record is non-executable, x402 cannot unlock them, and local stdio has no bearer principal with which to expose them. See the Agent Room guide.

The canonical registry ownership marker is:

mcp-name: io.github.beepboop2025/seiche

Data and licensing boundary

The source code is licensed under AGPL-3.0-or-later. Upstream data keeps its own terms: Seiche's software license does not grant redistribution rights over data from third parties. Public outputs distinguish redistributable observations, bounded derived context, metadata-only sources, restricted inputs, and declared gaps. Review the source citation and rights fields before republishing data.

For research citation, use CITATION.cff; for defects or data questions, open a GitHub issue.

Metadata

Release files for seiche 0.16.12

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for seiche 0.16.12
File Size Uploaded Provenance Actions
seiche-0.16.12.tar.gz 1.4 MB With provenance Details for seiche-0.16.12.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for seiche 0.16.12
File Interpreter ABI Platform Actions
seiche-0.16.12-py3-none-any.whl Python 3 none any Details for seiche-0.16.12-py3-none-any.whl

Total release size: 3.0 MB

Release files / seiche-0.16.12.tar.gz

Download URL seiche-0.16.12.tar.gz
Size 1.4 MB
Tags Source
SHA-256 checksum
How to use checksums
254f4ed9ce76af2fbf610b1bb14b29dfe41762ae4b6f7ff3fb0e5b2723f776a2
BLAKE2b-256 checksum
How to use checksums
72c63c472677af5c63e36457a17b7b90201b533ee49e960c4f4bc1b6ad4692c2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / seiche-0.16.12-py3-none-any.whl

Download URL seiche-0.16.12-py3-none-any.whl
Size 1.6 MB
Tags Python 3
SHA-256 checksum
How to use checksums
c23981f7564b7d08aa9a9d5fe17c6208061171a6a63d5f2598590005066a90bf
BLAKE2b-256 checksum
How to use checksums
3582393540d2ff0063e95e63715414af93b14a9aed672ee5b9a8cf0c787d982e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Security for seiche 0.16.12

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for seiche-0.16.12.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

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.

Release history Release notifications | RSS feed

This release

0.16.12 This release

2 release files Full provenance

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