toolstem/toolstem-mcp-server

**Curated financial data MCP for AI agents — equity research in one call.**
Toolstem is the **financial data MCP** built for AI stock analysis, equity research, and agent-driven investment workflows. Real-time stock data, company fundamentals, DCF valuations, financial metrics, and the ability to compare companies side-by-side — all returned as flat, agent-friendly JSON with derived signals already computed.
Works natively with **Claude**, **OpenAI Agents SDK**, and **LangChain**. Pay-per-call pricing, no subscription. More finance MCP servers (SEC filings, insider transactions, institutional holdings) are on the way.
Unlike passthrough wrappers that just expose a vendor's REST API, every Toolstem tool **combines multiple data sources**, **derives signals**, and **pre-computes the math** an agent would otherwise have to do itself.
One call. One agent-friendly JSON response. No nested arrays to parse, no cross-endpoint stitching, no null-checking boilerplate.
---
Quickstart — hosted endpoint (recommended)
Point your MCP client or agent at the hosted endpoint. **No API key, no infra, no setup.** Billing is per-call via x402 — the agent's wallet pays directly in USDC on Base mainnet.
- **No FMP API key required** — you do not bring or manage any upstream data key.
- **No infrastructure** — nothing to install, host, or keep running.
- **No setup** — connect an MCP client and call a tool.
- initialize and tools/list are **free** (discovery and schema introspection).
- Each tools/call costs **$0.01 USDC** on Base mainnet, settled via x402.
Claude Desktop
Drop this into your claude_desktop_config.json:
Restart Claude Desktop, then ask: *"Use Toolstem to get a snapshot of NVDA."*
Any MCP client (LangChain.js)
The official @langchain/mcp-adapters library connects directly to the hosted URL:
LangChain quick-start (langchain-toolstem)
The langchain-toolstem wrapper handles x402 payment for you — pass a funded wallet key and the tools auto-pay per call:
Prefer to run the server yourself with your own FMP key? See Advanced: self-host at the bottom.
Try the tools live in the Toolstem playground.
Product page: .
---
Pricing
- **MCP initialize and tools/list are free** — discovery, schema introspection, and health checks never cost anything.
- **tools/call costs $0.01 USDC on Base mainnet per invocation, paid via x402.** No API key, no signup, no marketplace account required — the agent's wallet pays directly.
| Tool | Per call |
|------|----------|
| get_stock_snapshot | $0.01 USDC |
| get_company_metrics | $0.01 USDC |
| compare_companies | $0.01 USDC |
How billing works
Toolstem uses the x402 payment protocol. Agents pay per call in USDC on Base — no API keys, no subscriptions, no invoices. The agent's wallet settles each call automatically via EIP-3009.
---
How it works
Toolstem ships as a Node MCP server (this repo) **and** as a hosted, x402-gated proxy.
- **Cloudflare Worker** terminates the public MCP connection at mcp.toolstem.com and enforces the x402 payment for tools/call.
- **MCP server** (this package) implements the 3 composite tools and talks to Financial Modeling Prep.
- **x402 on Base mainnet** handles the micropayment — settlement is sub-second, no off-chain accounts.