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

Get Credits

Purchase credits at leanmcp.com

Create API Key

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

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

Option	Description
`npm`	AI SDK package (`@ai-sdk/openai-compatible` for gateway)
`name`	Display name in OpenCode UI
`options.baseURL`	LeanMCP AI Gateway endpoint
`options.apiKey`	Can be set here or via `/connect`
`options.headers`	Custom headers for requests
`models`	Map 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

Run OpenCode: opencode
Select a LeanMCP model: /models
Ask a question
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

Provider not appearing in /models

Verify opencode.json is in your project root or ~/.config/opencode/
Check JSON syntax is valid
Restart OpenCode after config changes

Authentication errors

Run /connect and re-enter your API key
Verify the API key has SDK permissions
Check you have credits in your account

Model not working

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

Overview

For Users

For Developers

Features

OpenCode

OpenCode Integration

Prerequisites

Configuration

Configuration File

Using LeanMCP in OpenCode

Configuration Options

Setting Token Limits

Environment Variables

Multiple Providers via LeanMCP

Verifying Setup

Benefits

Unified Logging

Multi-Provider

Cost Tracking

Security

Troubleshooting

Resources

Next Steps

View Logs

SDK Integration

​OpenCode Integration

​Prerequisites

​Configuration

​Configuration File

​Using LeanMCP in OpenCode

​Configuration Options

​Setting Token Limits

​Environment Variables

​Multiple Providers via LeanMCP

​Verifying Setup

​Benefits

Unified Logging

Multi-Provider

Cost Tracking

Security

​Troubleshooting

​Resources

​Next Steps

View Logs

SDK Integration

OpenCode Integration

Prerequisites

Configuration

Configuration File

Using LeanMCP in OpenCode

Configuration Options

Setting Token Limits

Environment Variables

Multiple Providers via LeanMCP

Verifying Setup

Benefits

Troubleshooting

Resources

Next Steps