within-sdk (Python)

Within usage capture for Python MCP servers — official FastMCP, community FastMCP v2/v3, and low-level mcp servers.

from mcp.server.fastmcp import FastMCP
from within_sdk import track, WithinOptions, UserIdentity

server = FastMCP("acme")

track(server, "acme", WithinOptions(
    api_key=os.environ["WITHIN_SDK_API_KEY"],
    identify=lambda request, extra: UserIdentity(
        user_id=current_user_uuid(extra), user_name=None, user_data=None
    ),
))

The user identifier is hashed locally (SHA-256, byte-identical to the TypeScript SDK and the outcomes connector) before anything leaves the process; raw identifiers never go on the wire. Events publish to https://api.getwith.in/v1/ingest/events (override with WITHIN_SDK_INGEST_BASE_URL).

Forked from mcpcat-python-sdk (MIT).