Skip to main content

​
Config file location

~/.codeium/windsurf/mcp_config.json

​
Minimal configuration

{
  "mcpServers": {
    "isthmus": {
      "command": "isthmus",
      "env": {
        "DATABASE_URL": "postgres://user:password@localhost:5432/mydb"
      }
    }
  }
}

​
Full configuration

{
  "mcpServers": {
    "isthmus": {
      "command": "isthmus",
      "args": ["--audit-log", "/tmp/isthmus-audit.ndjson"],
      "env": {
        "DATABASE_URL": "postgres://user:password@localhost:5432/mydb",
        "SCHEMAS": "public,analytics",
        "POLICY_FILE": "/path/to/policy.yaml",
        "MAX_ROWS": "500"
      }
    }
  }
}

​
Verify

  1. Save the config file
  2. Restart Windsurf
  3. Open the Cascade AI panel
  4. Ask: “What tables are in my database?”

​
Troubleshooting

Use the full path to the binary. The location depends on how you installed:
  • Install script / prebuilt binary: /usr/local/bin/isthmus
  • go install: ~/go/bin/isthmus
"command": "/usr/local/bin/isthmus"
Find the path with which isthmus.
Ensure the file is at exactly ~/.codeium/windsurf/mcp_config.json. Create the directory structure if it doesn’t exist. Restart Windsurf after changes.
Test connectivity first:
DATABASE_URL="postgres://user:password@localhost:5432/mydb" isthmus --dry-run