Quickstart

pip install hmdl

npm install hmdl

from hmdl import HeimdallClient, trace_mcp_tool

# Initialize the client
client = HeimdallClient(
    endpoint="http://localhost:4318",
    org_id="your-org-id",           # From Settings page
    project_id="your-project-id",   # From Settings page
    service_name="my-mcp-server",
    environment="development"
)

# Decorate your MCP tools
@trace_mcp_tool()
def search_tool(query: str, limit: int = 10) -> dict:
    # Your tool logic here
    return {"results": [], "query": query, "limit": limit}

# Run your tool
result = search_tool("test query", limit=5)

# Flush traces before exit
client.flush()

import { HeimdallClient, traceMCPTool } from 'hmdl';

// Initialize the client
const client = new HeimdallClient({
  endpoint: "http://localhost:4318",
  orgId: "your-org-id",           // From Settings page
  projectId: "your-project-id",   // From Settings page
  serviceName: "my-mcp-server",
  environment: "development"
});

// Wrap your MCP tools
const searchTool = traceMCPTool(
  async (query: string, limit: number = 10) => {
    // Your tool logic here
    return { results: [], query, limit };
  },
  { name: "search-tool", paramNames: ["query", "limit"] }
);

// Run your tool
await searchTool("test query", 5);

// Flush traces before exit
await client.flush();