Quickstart

1. Install

pip install toolpulse
# or
npm install toolpulse

2. Get an API key

Sign in — your first API key is auto-issued and shown once.

export TOOLPULSE_API_KEY=tp_live_xxxxxxxxxxxxx

3. Wrap a tool

from toolpulse import monitor

@monitor(tool_name="search_web", agent_id="my-agent")
async def search_web(query: str) -> dict:
    # your existing code, unchanged
    ...

4. Run your agent

That's it. Every call is recorded. Open the dashboard to see latency and success rate per tool, drift events as they happen, and recent calls with their response shapes.

5. Configure alerts (optional)

Add a Discord, Slack, or webhook alert channel from the dashboard, then drift events and synthetic-check failures fan out to all configured channels.

MCP servers — wrap the whole server in one line

from mcp.server.fastmcp import FastMCP
from toolpulse import wrap_mcp_server

mcp = FastMCP("my-server")
# ... register your tools ...
wrap_mcp_server(mcp, agent_id="my-mcp-server")