Skip to main content

​
OpenCode Integration

OpenCode is a powerful CLI tool for AI-assisted coding that supports 75+ LLM providers. You can configure it to use the LeanMCP AI Gateway as a custom provider.
OpenCode uses the AI SDK and supports any OpenAI-compatible API, making it perfect for the LeanMCP AI Gateway.

​
Prerequisites

1

Get Credits

Purchase credits at ship.leanmcp.com
2

Create API Key

Create an API key at ship.leanmcp.com/api-keys with SDK permissions
3

Install OpenCode

npm install -g opencode
# or
brew install opencode

​
Configuration

​
Configuration File

Create or update opencode.json in your project directory (or ~/.config/opencode/opencode.json for global use): 
{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "leanmcp": {
            "npm": "@ai-sdk/openai-compatible",
            "name": "LeanMCP Custom Provider",
            "options": {
                "baseURL": "https://aigateway.leanmcp.com/v1/anthropic/",
                "apiKey": "leanmcp_your_api_key_here"
            },
            "models": {
                "claude-sonnet-4-5": {
                    "name": "claude-sonnet-4-5"
                }
            }
        }
    },
    "model": "leanmcp/claude-sonnet-4-5"
}
Replace leanmcp_your_api_key_here with your actual API key.

​
Using LeanMCP in OpenCode

Once configured, you can simply run: 
opencode
Since the model is defined in opencode.json as leanmcp/claude-sonnet-4-5, Opencode will automatically use it. To view available models: 
opencode
/models
Select leanmcp/claude-sonnet-4-5 if it’s not already selected.

​
Configuration Options

OptionDescription
npmAI SDK package (@ai-sdk/openai-compatible for gateway)
nameDisplay name in OpenCode UI
options.baseURLLeanMCP AI Gateway endpoint
options.apiKeyCan be set here or via /connect
options.headersCustom headers for requests
modelsMap of available models

​
Setting Token Limits

For proper context management, specify model limits: 
{
  "provider": {
    "leanmcp": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LeanMCP AI Gateway",
      "options": {
        "baseURL": "https://aigateway.leanmcp.com/v1/openai"
      },
      "models": {
        "gpt-5.2": {
          "name": "GPT-5.2",
          "limit": {
            "context": 128000,
            "output": 4096
          }
        }
      }
    }
  }
}

​
Environment Variables

Alternatively, set credentials via environment variables: 
# Add to your shell profile (~/.bashrc, ~/.zshrc)
export LEANMCP_API_KEY="leanmcp_your_api_key_here"
Then reference in config: 
{
  "provider": {
    "leanmcp": {
      "options": {
        "baseURL": "https://aigateway.leanmcp.com/v1/openai",
        "apiKey": "{env:LEANMCP_API_KEY}"
      }
    }
  }
}

​
Multiple Providers via LeanMCP

Route all your AI providers through LeanMCP: 
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "leanmcp-openai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenAI (via LeanMCP)",
      "options": {
        "baseURL": "https://aigateway.leanmcp.com/v1/openai"
      },
      "models": {
        "gpt-5.2": {},
        "gpt-5.2": {},
        "gpt-5.2": {}
      }
    },
    "leanmcp-anthropic": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Anthropic (via LeanMCP)",
      "options": {
        "baseURL": "https://aigateway.leanmcp.com/v1/anthropic"
      },
      "models": {
        "claude-sonnet-4-5-20250929": {},
        "claude-opus-4-5-20251101": {}
      }
    },
    "leanmcp-xai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "xAI Grok (via LeanMCP)",
      "options": {
        "baseURL": "https://aigateway.leanmcp.com/v1/xai"
      },
      "models": {
        "grok-beta": {}
      }
    }
  }
}

​
Verifying Setup

  1. Run OpenCode: opencode
  2. Select a LeanMCP model: /models
  3. Ask a question
  4. Check your LeanMCP Dashboard to see the logged request

​
Benefits

Unified Logging

All your OpenCode sessions logged in one place

Multi-Provider

Use OpenAI, Anthropic, xAI through one gateway

Cost Tracking

Track spending across all your coding sessions

Security

Detect if sensitive code is being sent

​
Troubleshooting

  • Verify opencode.json is in your project root or ~/.config/opencode/
  • Check JSON syntax is valid
  • Restart OpenCode after config changes
  • Run /connect and re-enter your API key
  • Verify the API key has SDK permissions
  • Check you have credits in your account
  • Ensure the model name matches what LeanMCP supports
  • Check the baseURL matches the provider (openai, anthropic, etc.)
  • Try a different model to isolate the issue

​
Resources

​
Next Steps

View Logs

See all your OpenCode requests

SDK Integration

Use in your own applications