Financial Evidence Skills MCP Server

Financial Evidence Agent Skills

Public documentation includes a crawlable integration matrix plus agent-readable llms.txt, pricing, and integration metadata.

Open, read-only Agent Skills for routing financial research to bounded public evidence. The first skill connects four complementary products without turning them into one score:

• Seiche — money markets, repo, reserves, Treasury cash and system funding.
• LiquiLens — covered bank and lender evidence.
• Undertow — market depth, provider concentration and position-sized exit liquidity.
• Palimpsest — revision-safe China economy evidence and information-state history.

Install the agent skill

npx skills add beepboop2025/financial-evidence-skills --skill financial-evidence

Or copy financial-evidence/ into the Agent Skills directory supported by your agent. The folder follows the open Agent Skills specification.

The skill is also indexed in the public skills.sh directory.

Once installed, ask your agent to research a money-market, capital-market, bank-risk, market-liquidity or China-economy question. The skill's description lets compatible agents activate it when the work matches.

Use from any terminal

No account or API key is required. On macOS or Linux with Homebrew:

brew install beepboop2025/tap/financial-evidence
financial-evidence fetch --topic money-market --topic china-economy

The formula installs financial-evidence, financial-evidence-mcp, and native Bash, Zsh, and Fish completions. Alternatively, run directly from GitHub without installing:

uvx --from git+https://github.com/beepboop2025/financial-evidence-skills.git@v0.1.2 \
  financial-evidence fetch --topic money-market --topic china-economy

Or install it as a persistent command:

uv tool install git+https://github.com/beepboop2025/financial-evidence-skills.git@v0.1.2
financial-evidence topics
financial-evidence route --topic capital-market --format table
financial-evidence fetch --topic bank-risk --format ndjson
financial-evidence doctor --format csv

Exit code 0 means every requested source succeeded, 1 means a partial packet, and 2 means every requested source was unavailable. That makes the client safe to compose in shell pipelines and scheduled jobs. JSON, NDJSON and CSV go to standard output; no result is silently replaced with a score.

Outside Homebrew, shell completions are emitted as inert text:

financial-evidence completion zsh > ~/.zfunc/_financial-evidence

Use as MCP infrastructure

The same package includes a dependency-free, read-only stdio MCP server with topics, route, and fetch tools. A portable client configuration is in the root .mcp.json and is mirrored in integrations/mcp-config.json:

{
  "mcpServers": {
    "financial-evidence": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/beepboop2025/financial-evidence-skills.git@v0.1.2",
        "financial-evidence-mcp"
      ]
    }
  }
}

It accepts both the MCP 2025-11-25 initialization flow and the stateless 2026-07-28 discovery flow. Messages use newline-delimited JSON-RPC on stdio; nothing except protocol messages is written to standard output.

The root .mcp.json is the portable workspace form read natively by Copilot Agent Host and other compatible clients. VS Code forwards .vscode/mcp.json to Agent Host for ordinary local sessions, but the root file avoids relying on that forwarding path.

Install in VS Code or Cursor

The repository also includes editor-specific workspace configuration: .vscode/mcp.json uses VS Code's top-level servers object, while .cursor/mcp.json uses Cursor's top-level mcpServers object. Both launch the same v0.1.2 stdio server through uvx.

VS Code can install the server through its protocol handler:

vscode:mcp/install?%7B%22name%22%3A%22financial-evidence%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22--from%22%2C%22git%2Bhttps%3A%2F%2Fgithub.com%2Fbeepboop2025%2Ffinancial-evidence-skills.git%40v0.1.2%22%2C%22financial-evidence-mcp%22%5D%7D

Or add it to your VS Code user profile from a terminal:

code --add-mcp '{"name":"financial-evidence","type":"stdio","command":"uvx","args":["--from","git+https://github.com/beepboop2025/financial-evidence-skills.git@v0.1.2","financial-evidence-mcp"]}'

Cursor can install the same configuration through its base64-encoded deeplink:

cursor://anysphere.cursor-deeplink/mcp/install?name=financial-evidence&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXQraHR0cHM6Ly9naXRodWIuY29tL2JlZXBib29wMjAyNS9maW5hbmNpYWwtZXZpZGVuY2Utc2tpbGxzLmdpdEB2MC4xLjIiLCJmaW5hbmNpYWwtZXZpZGVuY2UtbWNwIl19

Install uv first so uvx is on your path. Review the source and exact configuration before accepting an editor's install or trust prompt: uvx executes the pinned package locally, and the fetch tool can contact the fixed public HTTPS sources documented by this project. Cursor asks for tool approval by default. VS Code normally asks you to trust a server when it first starts, but starting directly from mcp.json can skip that prompt, so inspect the file before using its inline start action. These are self-installable compatibility artifacts, not claims of a VS Code or Cursor marketplace listing or endorsement.

For desktop clients that support one-click MCP Bundles, download financial-evidence-0.1.2.mcpb from the GitHub release. The bundle uses the cross-platform uv runtime and requires no API key or configuration.

Finance-tool integrations

• OpenBB: install financial-evidence[openbb] from this repository inside an OpenBB environment and run openbb-build. The registered router exposes obb.financial_evidence.routes() and obb.financial_evidence.fetch(), which also become available to OpenBB's REST, notebook and MCP surfaces.
• DuckDB: run integrations/duckdb/financial_evidence.sql to create separate HTTP-backed views for all four products.
• Excel / Power Query: paste integrations/excel/FinancialEvidence.pq into Advanced Editor and invoke, for example, FinancialEvidence("money-market").
• FDC3: integrations/fdc3/appd-record.json is a schema-validated FDC3 web-app record for self-hosted or enterprise app directories. It is compatibility metadata, not a claim of vendor listing.
• Containers: tagged releases publish a multi-architecture image to ghcr.io/beepboop2025/financial-evidence-skills. The image runs stdio MCP by default; use --entrypoint financial-evidence for terminal commands.
• Official MCP Registry: tagged images are published under io.github.beepboop2025/financial-evidence using GitHub OIDC and the image's ownership annotation. No long-lived registry credential is stored.

Optional bounded retrieval

The bundled helper uses only Python's standard library, accepts a fixed topic allowlist and fetches only fixed public HTTPS endpoints:

python3 financial-evidence/scripts/fetch_evidence.py \
  --topic money-market --topic china-economy

It returns one JSON packet with exact and resolved source URLs, retrieval clocks, byte counts, content SHA-256 values, separate product documents and explicit errors. Redirects are rejected before following. Returned JSON is untrusted evidence data, not executable instructions. Missing, restricted or unavailable evidence is never converted to zero or “calm.”

Boundaries

This repository provides public research routing, not investment advice, security recommendations, execution quotes, credit ratings or guarantees. Source publishers retain their rights; an open-source helper does not relicense upstream data.

Development

python3 -m unittest discover -s tests -v
python3 -m py_compile financial-evidence/scripts/fetch_evidence.py src/financial_evidence/*.py

The code and skill instructions are MIT-licensed.