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.10

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.10
File Size Uploaded Provenance Actions
seiche-0.16.10.tar.gz 1.3 MB With provenance Details for seiche-0.16.10.tar.gz

Built distribution (wheel)

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

Total release size: 2.7 MB

Release files / seiche-0.16.10.tar.gz

Download URL seiche-0.16.10.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
422bc959811631c069aba314142a7f51e4f6d37d60bed10536213a12150ca7a1
BLAKE2b-256 checksum
How to use checksums
c5079458f4d1ad069a27971c58483ca0b9e6ca525bec2df1b13fc6c6de691000
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 Oct 29, 2026.

Transparency log

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

Download URL seiche-0.16.10-py3-none-any.whl
Size 1.4 MB
Tags Python 3
SHA-256 checksum
How to use checksums
950a56e6c9ea67cf45d81cdbf32b42aba14fb6c5f1499f296267e85b751a7f41
BLAKE2b-256 checksum
How to use checksums
76921993cbe730a00a2a20f0aac7d6405e3d57fcc15cae7dedfa15eb52b8f1a8
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 Oct 29, 2026.

Transparency log

Security for seiche 0.16.10

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.10.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 Oct 29, 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.10 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