@ignitetech/g2-mcp

AI-powered copilot for Gensym. Provides 40+ tools for searching Gensym documentation, analyzing knowledge bases, generating Gensym code, and exporting KB contents — all accessible from your AI coding assistant.

Prerequisites

• Node.js 18+
• Gensym installation (required only for KB export — documentation and search tools work without it)
• API key provided by your administrator

Setup

Add the following to your MCP client configuration (Cursor, Claude Desktop, Windsurf, etc.):

{
  "mcpServers": {
    "g2-mcp": {
      "command": "npx",
      "args": [
        "@ignitetech/g2-mcp",
        "https://g2mcp.ignitetech.ai/mcp/",
        "--header",
        "X-API-KEY:${GENSYM_MCP_API_KEY}"
      ],
      "env": {
        "GENSYM_MCP_API_KEY": "<your-api-key>",
        "GENSYM_ROOT": "C:\\g2-2023-64\\g2"
      }
    }
  }
}

If you only need documentation and search tools (no KB export), you can omit GENSYM_ROOT:

{
  "mcpServers": {
    "g2-mcp": {
      "command": "npx",
      "args": [
        "@ignitetech/g2-mcp",
        "https://g2mcp.ignitetech.ai/mcp/",
        "--header",
        "X-API-KEY:${GENSYM_MCP_API_KEY}"
      ],
      "env": {
        "GENSYM_MCP_API_KEY": "<your-api-key>"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | GENSYM_MCP_API_KEY | Yes | API key for the Gensym MCP server | | GENSYM_ROOT | For KB export & local analysis | Path to your Gensym installation directory (e.g., C:\g2-2023-64\g2 or /opt/g2/g2). When set, the proxy exposes local KB export and analysis tools that operate on your machine's KB exports. | | GENSYM_API_URL | For write-enabled mode | Base URL of a running Gensym API server (default: http://localhost:8082). When set, the proxy exposes compile / CRUD / save / merge tools that operate on a live Gensym instance. | | GENSYM_EXPORT_PATH | Optional | Override for the export file location. Defaults to <target-kb-dir>/g2-mcp-export.js (same directory as the source KB). | | GENSYM_READ_ONLY | Optional | Set to "true" to disable write tools (create_gensym_*, update_gensym_item, delete_gensym_item, save_gensym_kb, merge_gensym_kb) at the proxy layer. |

What You Can Do

Once configured, ask your AI assistant to:

• Search documentation — "How do I create a rule in Gensym?"
• Generate Gensym code — "Write a procedure that calculates average temperature"
• Analyze your KB — "Show me a summary of my knowledge base"
• Find dependencies — "What procedures does calculate-flow call?"
• Export a KB — "Export the g2-copilot knowledge base"

Troubleshooting

Tools not loading Verify your API key is correct and that the server URL in your config is reachable.

KB export not working Ensure GENSYM_ROOT points to your Gensym installation directory and that the target KB path is correct.

Support

Contact your Gensym administrator for API keys and support.