Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.boltzpay.ai/llms.txt

Use this file to discover all available pages before exploring further.

CrewAI natively supports MCP. The BoltzPay MCP server works out of the box with no Python package needed. 
from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import StdioServerParameters

server_params = StdioServerParameters(
    command="npx",
    args=["-y", "@boltzpay/mcp"],
    env={"BOLTZPAY_DAILY_BUDGET": "5.00"},
)

with MCPServerAdapter(server_params) as tools:
    agent = Agent(role="Researcher", goal="Access paid APIs", tools=tools)
    task = Task(description="Discover paid APIs", expected_output="API list", agent=agent)
    Crew(agents=[agent], tasks=[task]).kickoff()
This gives your agent all 7 BoltzPay tools automatically.
Add Coinbase credentials to the env dict to enable payments. Without them, the agent can discover and quote for free.

​
Alternative: CLI Bridge Tools

For teams who prefer native Python tools over MCP: 
pip install boltzpay-crewai
Requires Node.js 20+ (the tools call npx @boltzpay/cli under the hood). 
from crewai import Agent, Task, Crew
from boltzpay_crewai import (
    BoltzPayFetchTool,
    BoltzPayQuoteTool,
    BoltzPayDiscoverTool,
)

agent = Agent(
    role="Data Researcher",
    goal="Find and access paid APIs using BoltzPay",
    tools=[BoltzPayFetchTool(), BoltzPayQuoteTool(), BoltzPayDiscoverTool()],
)

task = Task(
    description="Discover paid APIs and get pricing for invy.bot",
    expected_output="API pricing report",
    agent=agent,
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()

​
Tools

ToolNameDescriptionCredentials
BoltzPayFetchToolboltzpay_fetchFetch data from a paid API, auto-pay with USDCYes
BoltzPayQuoteToolboltzpay_quoteGet price quote without payingNo
BoltzPayDiscoverToolboltzpay_discoverBrowse available paid APIsNo
BoltzPayBudgetToolboltzpay_budgetShow remaining spending budgetNo
BoltzPayHistoryToolboltzpay_historyShow payment historyNo
BoltzPayWalletToolboltzpay_walletShow wallet and config infoNo
BoltzPayDiagnoseToolboltzpay_diagnoseFull endpoint diagnostic (DNS, protocol, health)No

​
Error Handling

CLI bridge tools return error strings instead of raising exceptions (CrewAI pattern), so your agent can recover gracefully: 
Error (NODE_NOT_FOUND): Node.js/npx not found. Install Node.js 20+ from https://nodejs.org
Error (TIMEOUT): CLI command timed out after 30s
Error (CLI_ERROR): Payment failed: budget exceeded