Metadata-Version: 2.5
Name: financial-evidence
Version: 0.1.9
Summary: MCP and API research infrastructure for AI finance agents, with persistent sessions and source-status streams
Project-URL: Homepage, https://beepboop2025.github.io/financial-evidence-skills/distribution/ai-trading-tools.html
Project-URL: Documentation, https://beepboop2025.github.io/financial-evidence-skills/agents/low-latency.md
Project-URL: MCP connection, https://agents.seiche.info/products/financial-evidence/mcp
Project-URL: API and source-status contract, https://agents.seiche.info/v1/context/contract
Project-URL: Issues, https://github.com/beepboop2025/financial-evidence-skills/issues
Project-URL: Source, https://github.com/beepboop2025/financial-evidence-skills
Author: Liquidity Lab
License-Expression: MIT
License-File: LICENSE
Keywords: ai-agents,capital-markets,china-economy,financial-data,forex,gift-city,gold,liquidity,mcp,model-context-protocol,money-markets,source-provenance,trading-research
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.10
Provides-Extra: openbb
Requires-Dist: openbb-core<3,>=1.6.13; extra == 'openbb'
Requires-Dist: pandas<4,>=1.5.3; extra == 'openbb'
Provides-Extra: workspace
Requires-Dist: fastapi<1,>=0.115; extra == 'workspace'
Requires-Dist: mcp<2,>=1.30; extra == 'workspace'
Requires-Dist: pyjwt[crypto]<3,>=2.15.1; extra == 'workspace'
Requires-Dist: uvicorn<1,>=0.30; extra == 'workspace'
Description-Content-Type: text/markdown

# Financial Evidence for AI agents

<!-- mcp-name: io.github.beepboop2025/financial-evidence -->

Read-only MCP and API research infrastructure for AI finance and trading agents.
Connect to funding, bank-risk, market-liquidity and economic evidence while keeping
source dates, coverage gaps and rights attached to the result. Operated by
LIQUILENS PRIVATE LIMITED.

## Install

Python 3.10 or newer:

```sh
python3 -m pip install 'financial-evidence[workspace]==0.1.9'
financial-evidence-trading doctor
financial-evidence-trading context
```

The `workspace` extra supplies the MCP/HTTP dependencies needed by the persistent
clients. The base package has no required dependencies and includes the terminal
and three-tool stdio router. Public hosted research reads need no data API key.
Optional subscriptions and client/model costs have separate terms.

## Reuse an MCP connection

```python
import asyncio
from financial_evidence.trading import ProductClient

async def main():
    async with ProductClient(mode="test", timeout=15) as client:
        first = await client.call("seiche", "data_health")
        again = await client.call("seiche", "data_health")
        print(first["timing"], again["timing"])

asyncio.run(main())
```

`mode="test"` labels verification traffic. Repeated reads reuse the bounded
session; failed requests are not automatically replayed. Session reuse does not
make source data fresher or grant trading authority.

## Read compact source-status updates

```python
import asyncio
from financial_evidence.trading.context import ContextClient

async def main():
    async with ContextClient() as client:
        snapshot = await client.snapshot()
        print(snapshot)

asyncio.run(main())
```

The public source-status routes are:

- [Contract](https://agents.seiche.info/v1/context/contract)
- [Snapshot](https://agents.seiche.info/v1/context/snapshot)
- [SSE events](https://agents.seiche.info/v1/context/events)

These report metadata, not live quotes. Source freshness, source rights and stream
liveness are separate. See the [Python/JavaScript stream guide](https://beepboop2025.github.io/financial-evidence-skills/agents/low-latency.md)
for expiry, reset and reconnect handling. The JavaScript companion is available
from that guide and is not represented as a Python module.

## Connect an MCP client

For hosted financial research, add this Streamable HTTP endpoint:

```text
https://agents.seiche.info/products/financial-evidence/mcp
```

Start with `financial_evidence_agent_query` and
`{"dataset":"money_markets","entity":"USD","limit":3}`.
Download the [product MCP configurations](https://beepboop2025.github.io/financial-evidence-skills/connect/all-products.mcp.json)
for LiquiLens, Seiche, Undertow, Palimpsest and the other explicitly labelled
research, metadata and sandbox surfaces. Each endpoint has its own tool schema.

For the local three-tool research router:

```sh
uvx --from financial-evidence==0.1.9 financial-evidence mcp
```

The existing `financial-evidence-mcp` command remains available. The local router
exposes `financial_evidence_topics`, `financial_evidence_route` and
`financial_evidence_fetch`; it is separate from the hosted Research Desk tool set.

## Diagnostics and source admission

`financial-evidence-trading latency --samples 3` performs labelled synthetic reads.
`source-access` inspects the permission catalog, while `feed-pilot` runs invented
recovery fixtures. Neither obtains a feed licence, executes a trade or establishes
a production latency guarantee. Preserve unavailable and restricted results.

[Setup guide](https://beepboop2025.github.io/financial-evidence-skills/distribution/ai-trading-tools.html)
· [Source](https://github.com/beepboop2025/financial-evidence-skills)
· [Issues](https://github.com/beepboop2025/financial-evidence-skills/issues)
· [Licence](https://github.com/beepboop2025/financial-evidence-skills/blob/main/LICENSE)
