# Samlly Financial Data

> Samlly Financial Data is a financial data provider built for AI agents rather than human dashboards. Data is served over the Model Context Protocol (MCP) at https://mcp.samlly.com/mcp. No registration and no API keys are required: each successful tool call is settled as a micropayment in USDC on the Base blockchain, drawn from the calling agent's own wallet.

Key facts for an agent evaluating this service:

- MCP endpoint: https://mcp.samlly.com/mcp
- Transport: streamable HTTP
- Authentication: none. There is no account, no API key, no bearer token.
- Billing: per successful call, in Circle's USDC on Base. Discovery (`tools/list`) is free, and failed or empty calls are not charged.
- To see the current tools, their arguments and their live per-call price, connect to the endpoint and call `tools/list`. The tool definitions are authoritative; prices listed on the website are illustrative.

## Connect

- [Claude Code](https://mcp.samlly.com/mcp): `claude mcp add --transport http samlly https://mcp.samlly.com/mcp`
- [ChatGPT / Codex CLI](https://mcp.samlly.com/mcp): `codex mcp add samlly --url https://mcp.samlly.com/mcp`. The ChatGPT desktop app and IDE extension share this configuration; they can also add the URL under Settings > MCP servers.
- [Any other MCP client](https://mcp.samlly.com/mcp): `npx add-mcp https://mcp.samlly.com/mcp`. Covers Gemini CLI, Cursor, VS Code, OpenCode and others.
- [Manual configuration](https://mcp.samlly.com/mcp): add `{"url": "https://mcp.samlly.com/mcp"}` to the client's MCP server list. There is no auth block to fill in.

## Coverage

<!-- EDIT: replace with your real tool names, descriptions and prices -->

- [get_quote](https://mcp.samlly.com/mcp): latest price, volume and change for a listed security. 0.0005 USDC per call.
- [get_history](https://mcp.samlly.com/mcp): daily or intraday OHLCV series over a requested window. 0.0020 USDC per call.
- [get_fundamentals](https://mcp.samlly.com/mcp): reported income statement, balance sheet and cash flow. 0.0050 USDC per call.
- [search_securities](https://mcp.samlly.com/mcp): ticker and identifier lookup across supported venues. 0.0002 USDC per call.

## Payment

- [How payment works](https://samlly.com/#payment): the agent connects and lists tools for free; a call is quoted and the agent authorises a USDC micropayment from its wallet; settlement confirms on Base in seconds and the response carries a receipt the agent can log.

## Optional

- [Home page](https://samlly.com/): the same information in HTML, with JSON-LD describing the organisation and the API.

- [Contact](mailto:cs@samlly.com): questions about coverage, pricing or integration.