Skip to main content
The Python SDK wraps a Python MCP server. It injects the mcpeyeIntent parameter into every tool, captures each call, and ships batches to your ingest API in the background.

​
Install

pip install mcpeye

​
Minimal usage

import os
from mcpeye import track

# Your existing MCP server instance, with tools already registered.
from my_server import server

# Injects mcpeyeIntent into every tool's schema and captures each call.
track(
    server,
    "your-project-id",
    ingest_url=os.environ.get("MCPEYE_INGEST_URL", "http://localhost:3001"),
    ingest_secret=os.environ.get("MCPEYE_INGEST_SECRET"),
)

​
Configuration

OptionEnv varDescription
project_id—Your project id (2nd arg to track), from “Create project”.
ingest_urlMCPEYE_INGEST_URLIngest API base URL. Required (no implicit localhost default).
ingest_secretMCPEYE_INGEST_SECRETThe per-project ingest secret from “Create project” / POST /projects.
Tool arguments and results are redacted for obvious secrets before they leave your process, and the only network destination is the ingest URL you control.

What happens after capture

Ingest, sessionize, summarize, and the Intent Gap Report.