Skip to main content
Simforge provides an MCP (Model Context Protocol) server that lets coding agents like Cursor, Claude Code, and Windsurf set up Simforge tracing in your codebase automatically. The MCP server provides two tools:
  • setup_simforge — Returns a language-specific SDK setup guide with correct API usage, code examples, and best practices
  • get_simforge_api_key — Retrieves your API key for the agent to configure

​
Supported Languages

TypeScript

@goharvest/simforge — withSpan wrapper

Python

simforge-py — @span decorator

Ruby

simforge — simforge_span macro

Go

simforge-go — Start/End spans
You can also configure the MCP connection from the Simforge setup page.

​
Connecting Your Agent

​
Cursor

Add this to your .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global): 
{
  "mcpServers": {
    "simforge": {
      "url": "https://simforge.goharvest.ai/mcp"
    }
  }
}

​
Claude Code

Run this in your terminal: 
claude mcp add --transport sse simforge https://simforge.goharvest.ai/mcp

​
Windsurf

Add this to your MCP configuration: 
{
  "mcpServers": {
    "simforge": {
      "serverUrl": "https://simforge.goharvest.ai/mcp"
    }
  }
}

​
How It Works

Once connected, your coding agent can:
  1. Call get_simforge_api_key to retrieve your API key (requires your Simforge session)
  2. Call setup_simforge with a language parameter (typescript, python, ruby, or go) to get a complete setup guide
  3. Follow the guide to install the SDK, initialize the client, and instrument your functions
The agent receives the full SDK API reference including code examples, so it can make the correct changes without browsing documentation or guessing APIs.

​
Example Workflow

Ask your coding agent: 
Set up Simforge tracing for my project
The agent will:
  1. Detect your project language
  2. Call the MCP tools to get the API key and setup guide
  3. Install the SDK
  4. Ask which functions to instrument
  5. Add tracing with correct API usage
The MCP guide tells the agent to ask you which functions to instrument before making changes, so you stay in control of what gets traced.