{
  "markdown": "# Financial Evidence Agent Skills\n\n**Try the underlying evidence first:** [Open three browser research questions](https://liquilens.in/start/)\nfor bank NPA disclosures, dollar funding and BTC exit estimates. Each example\ncalls its named public MCP after a click and displays the returned sources,\ndates and limits. No key or installation is needed. The page also has setup\nand starter questions for Financial Evidence and eight other hosted MCPs.\nThe browser examples call individual services; they do not verify an Evidence\nCarrier or evaluate a combined Financial Evidence packet.\n\n[![skills.sh](https://skills.sh/b/beepboop2025/financial-evidence-skills)](https://skills.sh/beepboop2025/financial-evidence-skills/financial-evidence)\n\n[Public documentation](https://beepboop2025.github.io/financial-evidence-skills/)\nincludes a crawlable integration matrix plus agent-readable `llms.txt`, pricing,\nintegration metadata, and a dated\n[third-party marketplace ledger](MARKETPLACE_STATUS.md).\nThe [v0.1.5 semantic contract](SEMANTIC_CONTRACT.md) defines transport-only\nstatus, source-reported adapter metadata, and the explicit non-Carrier boundary.\nVersion 0.1.5 is a signed, independently verified release. Its versioned\nAgent Skill, terminal, Codex, Gemini, editor, and bundle installs use the same\nrelease, with published artifacts, container, Registry record, and Homebrew\nformula. The Claude self-hosted marketplace command follows the repository's\nmutable default branch; review the checked-out commit before enabling it.\n\nOpen, read-only Agent Skills for routing financial research to bounded public\nevidence. The first skill connects four complementary products without turning\nthem into one score:\n\n- **Seiche** — money markets, repo, reserves, Treasury cash and system funding.\n- **LiquiLens** — covered bank and lender evidence.\n- **Undertow** — market depth, provider concentration and position-sized exit liquidity.\n- **Palimpsest** — revision-safe China economy evidence and information-state history.\n\nFor a daily research workflow, [Market Brief](https://github.com/beepboop2025/market-brief)\nprovides free, source-cited funding, capital-market and liquidity briefs with local\nchange comparisons. This separately versioned browser companion and agent skill\nuses the existing public evidence sources.\n\n## Install the agent skill\n\n```bash\nnpx skills add https://github.com/beepboop2025/financial-evidence-skills/tree/v0.1.5/financial-evidence \\\n  --skill financial-evidence\n```\n\nOr copy [`financial-evidence/`](financial-evidence/) into the Agent Skills\ndirectory supported by your agent. The folder follows the open\n[Agent Skills specification](https://agentskills.io/specification).\n\nThe skill is also indexed in the public\n[skills.sh directory](https://skills.sh/beepboop2025/financial-evidence-skills/financial-evidence).\n\nOnce installed, ask your agent to research a money-market, capital-market,\nbank-risk, market-liquidity or China-economy question. The skill's description\nlets compatible agents activate it when the work matches.\n\n## Use from any terminal\n\nNo account or API key is required. On macOS or Linux with Homebrew:\n\n```bash\nbrew install beepboop2025/tap/financial-evidence\nfinancial-evidence fetch --topic money-market --topic china-economy\n```\n\nThe formula installs `financial-evidence`, `financial-evidence-mcp`, and native\nBash, Zsh, and Fish completions. Alternatively, run directly from GitHub\nwithout installing:\n\n```bash\nuvx --from git+https://github.com/beepboop2025/financial-evidence-skills.git@v0.1.5 \\\n  financial-evidence fetch --topic money-market --topic china-economy\n```\n\nOr install it as a persistent command:\n\n```bash\nuv tool install git+https://github.com/beepboop2025/financial-evidence-skills.git@v0.1.5\nfinancial-evidence topics\nfinancial-evidence route --topic capital-market --format table\nfinancial-evidence fetch --topic bank-risk --format ndjson\nfinancial-evidence doctor --format csv\n```\n\nExit code `0` means every requested source was retrieved, `1` means transport\nwas partial, and `2` means every requested source was unavailable. Legacy\npacket `status` is preserved and equals `transport_status`; both mean transport\nreachability only. Every packet says `status_semantics: transport_only`,\n`evidence_status: not_evaluated`, and `carrier_verification: not_performed`.\nThat makes the client safe to compose in shell pipelines without mistaking an\nHTTP success for validated evidence or a verified Evidence Carrier. JSON,\nNDJSON, and CSV go to standard output; no result is silently replaced with a\nscore.\n\nOutside Homebrew, shell completions are emitted as inert text:\n\n```bash\nfinancial-evidence completion zsh > ~/.zfunc/_financial-evidence\n```\n\n## Use as MCP infrastructure\n\nThe public Streamable HTTP endpoint requires no local install, account, or API\nkey:\n\n```text\nhttps://liquilens.in/mcp/financial-evidence\n```\n\nIt exposes the same three read-only `topics`, `route`, and `fetch` tools for\nclients that support remote MCP. The root [`.mcp.json`](.mcp.json) is the\nportable plugin configuration for that public remote:\n\n```json\n{\n  \"mcpServers\": {\n    \"financial-evidence\": {\n      \"type\": \"http\",\n      \"url\": \"https://liquilens.in/mcp/financial-evidence\"\n    }\n  }\n}\n```\n\nThe package also includes a dependency-free stdio server for local or\noffline-compatible client setups. Its pinned configuration is in\n[`integrations/mcp-config.json`](integrations/mcp-config.json). Both transports\naccept the MCP `2025-11-25` initialization flow and the stateless `2026-07-28`\ndiscovery flow. Local stdio messages use newline-delimited JSON-RPC; nothing\nexcept protocol messages is written to standard output.\n\nThe official MCP Registry record publishes both the multi-architecture OCI\npackage and the public Streamable HTTP endpoint. Remote clients do not need\n`uv`, Docker, a credential, or a local subprocess.\n\n### Install in Gemini CLI or Claude Code\n\nGemini CLI can install this repository as an extension. Its root\n[`gemini-extension.json`](gemini-extension.json) connects only to the fixed\npublic remote MCP endpoint and allowlists the three read-only tools; the\nmirrored `skills/financial-evidence` folder gives Gemini the domain routing\ninstructions as well:\n\n```bash\ngemini extensions install https://github.com/beepboop2025/financial-evidence-skills \\\n  --ref v0.1.5\n```\n\nClaude Code can add this repository as a self-hosted marketplace and install\nthe bundled plugin:\n\n```bash\nclaude plugin marketplace add beepboop2025/financial-evidence-skills\nclaude plugin install financial-evidence@liquidity-lab\n```\n\nThis Claude command follows the mutable default branch. Review the checked-out\ncommit before enabling the plugin; the versioned install routes above remain\npinned to the verified release.\n\nThe Claude plugin loads the same byte-identical Agent Skill plus the root\n`.mcp.json` public remote server. These are direct, self-hosted install routes;\nthey do not imply inclusion in a vendor-operated marketplace or endorsement.\n\n### Install in Codex; prepare ChatGPT\n\nCodex can add the repository's plugin marketplace and then install the plugin:\n\n```bash\ncodex plugin marketplace add beepboop2025/financial-evidence-skills --ref v0.1.5\ncodex plugin add financial-evidence@liquidity-lab\n```\n\nThe OpenAI plugin package combines the byte-identical Agent Skill with the\npublic remote MCP endpoint. The Codex repository install route is public. A\nChatGPT and Codex universal-directory submission is also prepared, but has not\nbeen submitted, approved, or published by OpenAI. The remaining review,\npublisher-identity, and domain-challenge steps belong to the OpenAI account\nowner. See [`OPENAI_PLUGIN_SUBMISSION.md`](OPENAI_PLUGIN_SUBMISSION.md) for the\nlisting copy and required positive and negative tests.\n\nThe root `.mcp.json` is the portable plugin form for the public remote MCP\nserver. VS Code and Cursor retain separate workspace files for the pinned local\nstdio server, so plugin installs do not depend on a local Python process while\neditor workspaces can still use one.\n\n### Install in VS Code or Cursor\n\nThe repository also includes editor-specific workspace configuration:\n[`.vscode/mcp.json`](.vscode/mcp.json) uses VS Code's top-level `servers`\nobject, while [`.cursor/mcp.json`](.cursor/mcp.json) uses Cursor's top-level\n`mcpServers` object. Public install links currently launch the verified v0.1.5\nstdio server through `uvx`, matching the repository manifests.\n\nVS Code can install the server through its protocol handler:\n\n```text\nvscode: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.5%22%2C%22financial-evidence-mcp%22%5D%7D\n```\n\nOr add it to your VS Code user profile from a terminal:\n\n```bash\ncode --add-mcp '{\"name\":\"financial-evidence\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"--from\",\"git+https://github.com/beepboop2025/financial-evidence-skills.git@v0.1.5\",\"financial-evidence-mcp\"]}'\n```\n\nCursor can install the same configuration through its base64-encoded deeplink:\n\n```text\ncursor://anysphere.cursor-deeplink/mcp/install?name=financial-evidence&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXQraHR0cHM6Ly9naXRodWIuY29tL2JlZXBib29wMjAyNS9maW5hbmNpYWwtZXZpZGVuY2Utc2tpbGxzLmdpdEB2MC4xLjUiLCJmaW5hbmNpYWwtZXZpZGVuY2UtbWNwIl19\n```\n\nInstall `uv` first so `uvx` is on your path. Review the source and exact\nconfiguration before accepting an editor's install or trust prompt: `uvx`\nexecutes the pinned package locally, and the `fetch` tool can contact the fixed\npublic HTTPS sources documented by this project. Cursor asks for tool approval\nby default. VS Code normally asks you to trust a server when it first starts,\nbut starting directly from `mcp.json` can skip that prompt, so inspect the file\nbefore using its inline start action. These are self-installable compatibility\nartifacts, not claims of a VS Code or Cursor marketplace listing or endorsement.\n\nFor desktop clients that support one-click MCP Bundles, download\n`financial-evidence-0.1.5.mcpb` from the last verified GitHub release. The bundle uses the\ncross-platform `uv` runtime and requires no API key or configuration.\n\n## Finance-tool integrations\n\n- **Remote MCP:** connect any Streamable HTTP client to\n  `https://liquilens.in/mcp/financial-evidence`; no local runtime, account, or\n  API key is required.\n- **Gemini CLI:** the root extension manifest bundles the Agent Skill and\n  allowlists the three tools exposed by the public remote MCP endpoint.\n- **Claude Code:** the self-hosted `liquidity-lab` marketplace installs the\n  versioned plugin, Agent Skill, and MCP configuration from this repository.\n- **Codex:** the repository marketplace installs the Agent Skill and public\n  remote MCP package directly.\n- **ChatGPT:** the universal-directory submission packet is prepared; public\n  availability remains pending account-owned verification, submission,\n  review, and publication.\n- **OpenBB:** install `financial-evidence[openbb]` from this repository inside\n  an OpenBB environment and run `openbb-build`. The registered router exposes\n  `obb.financial_evidence.routes()` and `obb.financial_evidence.fetch()`, which\n  also become available to OpenBB's REST, notebook and MCP surfaces.\n- **DuckDB:** run\n  [`integrations/duckdb/financial_evidence.sql`](integrations/duckdb/financial_evidence.sql)\n  to create separate HTTP-backed views for all four products.\n- **Excel / Power Query:** paste\n  [`integrations/excel/FinancialEvidence.pq`](integrations/excel/FinancialEvidence.pq)\n  into Advanced Editor and invoke, for example,\n  `FinancialEvidence(\"money-market\")`.\n- **FDC3:**\n  the public [Financial Evidence Inspector](https://beepboop2025.github.io/financial-evidence-skills/integrations/fdc3/evidence-inspector/)\n  receives and broadcasts declared standard contexts through `window.fdc3`.\n  [`integrations/fdc3/appd-record.json`](integrations/fdc3/appd-record.json)\n  is its FDC3 2.0 web-app record for self-hosted or enterprise directories. The\n  same record is served as [raw JSON](https://beepboop2025.github.io/financial-evidence-skills/integrations/fdc3/appd-record.json)\n  for direct directory ingestion. The record and runtime do not imply FINOS\n  review, directory acceptance, or vendor endorsement.\n- **Containers:** tagged releases publish a multi-architecture image to\n  `ghcr.io/beepboop2025/financial-evidence-skills`. The image runs stdio MCP by\n  default; use `--entrypoint financial-evidence` for terminal commands.\n- **Official MCP Registry:** tagged images are published under\n  `io.github.beepboop2025/financial-evidence` using GitHub OIDC and the image's\n  ownership annotation. No long-lived registry credential is stored.\n\n### Release integrity\n\nEach tagged release rebuilds and retests the Python and JavaScript contracts\nfrom the exact signed `main` commit before publication. The release attaches a\nwheel, source archive, MCP bundle, CycloneDX SBOM, and `SHA256SUMS`; GitHub\nSigstore build-provenance attestations bind every downloadable artifact to the\nrelease workflow. Consumers can verify an artifact with `gh attestation verify`\nagainst `beepboop2025/financial-evidence-skills`.\n\n## Optional bounded retrieval\n\nThe bundled helper uses only Python's standard library, accepts a fixed topic\nallowlist and fetches only fixed public HTTPS endpoints:\n\n```bash\npython3 financial-evidence/scripts/fetch_evidence.py \\\n  --topic money-market --topic china-economy\n```\n\nIt returns one JSON packet with exact and resolved source URLs, canonical human\nscope URLs, retrieval clocks, byte counts, content SHA-256 values, separate\nproduct documents, and explicit errors. Successful responses also include only\nthe endpoint-specific source state and clocks named by explicit adapters, with\nRFC 6901 paths and fetched-byte provenance; missing configured fields are\n`not_reported`. The router does not infer freshness, eligibility, or rights.\nRoutes declare `financial_authority: none` and `carrier_state: not_published`,\nand therefore expose no `carrier_url`. Redirects are rejected before following.\nReturned JSON is untrusted evidence data, not executable instructions. Missing,\nrestricted, or unavailable evidence is never converted to zero or “calm.”\n\n## Boundaries\n\nThis repository provides public research routing, not investment advice,\nsecurity recommendations, execution quotes, credit ratings or guarantees.\nSource publishers retain their rights; an open-source helper does not relicense\nupstream data.\n\n[Support](https://beepboop2025.github.io/financial-evidence-skills/support/) ·\n[Privacy](https://beepboop2025.github.io/financial-evidence-skills/privacy/) ·\n[Terms](https://beepboop2025.github.io/financial-evidence-skills/terms/)\n\n## Development\n\n```bash\npython3 -m unittest discover -s tests -v\npython3 -m py_compile financial-evidence/scripts/fetch_evidence.py src/financial_evidence/*.py\n```\n\nThe code and skill instructions are MIT-licensed.\n",
  "bytes": 15057,
  "sha": "5c5c7fb946b5fc0725fac45365b79c25f8680b838bb103d0c8ab4a97c63b2001",
  "repo_slug": "beepboop2025/financial-evidence-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_beepboop2025_financial_evidenc_01c55269/readme"
}