# Microtoll

> Pay-per-use API gateway for AI agents. One wallet, all APIs.

Microtoll is a pay-per-use API gateway for AI agents. Instead of managing separate API keys and subscriptions for every service, your agent accesses paid APIs through a single MCP server — web search, transcription, image generation, LLMs, and more.

## Quick Start

- [Full Documentation](https://microtoll.io/llms-full.txt): Complete inline docs (wallet setup, SDK usage, all framework guides)
- [Machine-Readable Reference](https://microtoll.io/ai): Compact reference for autonomous agents

## Integration Guides

- [CrewAI Guide](https://microtoll.io/guides/crewai.md): MCP integration for CrewAI
- [LangChain / LangGraph Guide](https://microtoll.io/guides/langchain.md): MCP integration for LangChain / LangGraph
- [Cursor Guide](https://microtoll.io/guides/cursor.md): MCP integration for Cursor
- [OpenAI Agents SDK Guide](https://microtoll.io/guides/openai-agents.md): MCP integration for OpenAI Agents SDK
- [LlamaIndex Guide](https://microtoll.io/guides/llamaindex.md): MCP integration for LlamaIndex
- [AutoGen Guide](https://microtoll.io/guides/autogen.md): MCP integration for AutoGen
- [Haystack Guide](https://microtoll.io/guides/haystack.md): MCP integration for Haystack
- [Claude Code Guide](https://microtoll.io/guides/claude-code.md): MCP integration for Claude Code

## SDK & Tools

- Python SDK: `pip install microtoll`
- TypeScript SDK: `npm install microtoll`
- MCP Server: `pip install microtoll-mcp` (or `uvx microtoll-mcp`)
- CLI: `microtoll setup` / `microtoll wallet` / `microtoll fund`

## API Endpoints

- Browse APIs: https://microtoll.io/discover
- Registry API: `GET https://api.microtoll.io/registry/search`
- Consumer Registration: `POST https://api.microtoll.io/consumer/identify`

## Payment Flow

1. Call API → HTTP 402 with invoice
2. SDK pays automatically via Spark
3. Retry with proof → response returned
4. On upstream error → credit token issued (valid 7 days)