For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

OpenCode

Connect OpenCode to agentgateway

Configure OpenCode, the open source AI coding assistant, to use agentgateway as an MCP server.

Before you begin

1. Install and run agentgateway.
2. Confirm agentgateway is up by opening the agentgateway UI.
3. Use the MCP endpoint http://localhost:3000/mcp/http to connect your client to agentgateway. If you run agentgateway on a different host or port, replace localhost:3000 in the examples accordingly.

Configuration

Add agentgateway to your OpenCode configuration file opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "agentgateway": {
      "type": "remote",
      "url": "http://localhost:3000/mcp/http"
    }
  }
}

Project-Level Configuration

For project-specific configuration, create opencode.json in your project root:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "agentgateway": {
      "type": "remote",
      "url": "http://localhost:3000/mcp/http"
    }
  }
}

Authentication

Include authentication if required:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "agentgateway": {
      "type": "remote",
      "url": "http://localhost:3000/mcp/http",
      "headers": {
        "Authorization": "Bearer your-token-here"
      }
    }
  }
}