Skip to content

Update supported clients #250

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Oct 22, 2025
Merged

Update supported clients #250

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5f9fd6a
Update supported clients
danbarr Oct 21, 2025
fddf19f
Fix typo
danbarr Oct 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
69 changes: 41 additions & 28 deletions docs/toolhive/reference/client-compatibility.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,11 @@ We've tested ToolHive with these clients:
| -------------------------- | :-------: | :----------------: | ------------------------------------------- |
| GitHub Copilot (VS Code) | ✅ | ✅ | v1.102+ or Insiders version ([see note][3]) |
| Cursor | ✅ | ✅ | v0.50.0+ |
| Roo Code (VS Code) | ✅ | ✅ | v3.19.2+ |
| Cline (VS Code) | ✅ | ✅ | v3.17.10+ |
| Claude Code CLI | ✅ | ✅ | v1.0.27+ |
| Cline (VS Code) | ✅ | ✅ | v3.17.10+ |
| Continue (VS Code) | ✅ | ✅ | v1.0.14+ |
| Continue (JetBrains) | ✅ | ✅ | v1.0.23+ |
| Roo Code (VS Code) | ✅ | ✅ | v3.19.2+ |
| Windsurf IDE | ✅ | ✅ | |
| Windsurf (JetBrains) | ✅ | ✅ | |
| Sourcegraph Amp CLI | ✅ | ✅ | |
Expand All @@ -26,12 +28,11 @@ We've tested ToolHive with these clients:
| Sourcegraph Amp (Windsurf) | ✅ | ✅ | |
| LM Studio | ✅ | ✅ | v0.3.17+ |
| Goose | ✅ | ✅ | |
| Trae IDE | ✅ | ✅ | v1.4.1+ |
| ChatGPT Desktop | ✅ | ❌ | See [STDIO-only client configuration][4] |
| Claude Desktop | ✅ | ❌ | See [STDIO-only client configuration][4] |
| Kiro | ✅ | ❌ | See [STDIO-only client configuration][4] |
| GitHub Copilot (JetBrains) | ✅ | ❌ | v1.5.47+ |
| Continue (VS Code) | ✅ | ❌ | v1.0.14+ |
| Continue (JetBrains) | ✅ | ❌ | v1.0.23+ |
| PydanticAI | ✅ | ❌ | v0.2.18+ |

[3]: #vs-code-with-copilot
Expand Down Expand Up @@ -105,7 +106,7 @@ Example configuration:
{
"servers": {
"github": { "url": "http://localhost:19046/sse#github", "type": "sse" },
"fetch": { "url": "http://localhost:43832/sse#fetch", "type": "sse" },
"fetch": { "url": "http://localhost:43832/mcp", "type": "http" },
"osv": { "url": "http://localhost:51712/mcp", "type": "http" }
}
}
Expand All @@ -129,7 +130,7 @@ Example configuration:
{
"mcpServers": {
"github": { "url": "http://localhost:19046/sse#github" },
"fetch": { "url": "http://localhost:43832/sse#fetch" },
"fetch": { "url": "http://localhost:43832/mcp" },
"osv": { "url": "http://localhost:51712/mcp" }
}
}
Expand Down Expand Up @@ -157,7 +158,7 @@ Example configuration:

"mcpServers": {
"github": { "url": "http://localhost:19046/sse#github", "type": "sse" },
"fetch": { "url": "http://localhost:43832/sse#fetch", "type": "sse" },
"fetch": { "url": "http://localhost:43832/mcp", "type": "http" },
"osv": { "url": "http://localhost:51712/mcp", "type": "http" }
}
}
Expand All @@ -170,7 +171,7 @@ by creating a `.mcp.json` file in your project directory, or add servers using
the `claude` CLI:

```bash
claude mcp add --scope <user|project> --transport sse fetch http://localhost:43832/sse#fetch
claude mcp add --scope <user|project> --transport http fetch http://localhost:43832/mcp
```

### Roo Code and Cline
Expand Down Expand Up @@ -199,7 +200,7 @@ Example configuration:
{
"mcpServers": {
"github": { "url": "http://localhost:19046/sse#github", "type": "sse" },
"fetch": { "url": "http://localhost:43832/sse#fetch", "type": "sse" },
"fetch": { "url": "http://localhost:43832/mcp", "type": "streamable-http" },
"osv": { "url": "http://localhost:51712/mcp", "type": "streamable-http" }
// Note: Cline uses "streamableHttp" instead of "streamable-http"
}
Expand All @@ -212,6 +213,34 @@ you can also configure
[project-specific MCP servers](https://docs.roocode.com/features/mcp/using-mcp-in-roo#editing-mcp-settings-files)
by creating a `.roo/mcp.json` file in your project directory.

### Continue

The [Continue](https://continue.dev) extension stores its global MCP
configuration in a JSON file in your home directory. This file is used by both
the VS Code and JetBrains versions of Continue.

- **All platforms**: `~/.continue/config.yaml`

Example configuration:

```yaml
mcpServers:
- name: github
type: sse
url: http://localhost:19046/sse#github
- name: fetch
type: streamable-http
url: http://localhost:43832/mcp
```

Continue supports SSE (`type: sse`) and Streamable HTTP
(`type: streamable-http`) transports.

When you register Continue as a client, ToolHive automatically updates the
global MCP configuration file whenever you run an MCP server. You can also
configure project-specific MCP servers by creating a
`.continue/mcpServers/<name>.yaml` file file in your project directory.

## Manual configuration

If your client doesn't support automatic configuration, you'll need to set up
Expand All @@ -226,28 +255,12 @@ from pydantic_ai.mcp import MCPServerSSE
from pydantic_ai.mcp import MCPServerStreamableHTTP

# For Server-Sent Events (SSE)
server = MCPServerSSE(url='http://localhost:43832/sse#fetch')
server = MCPServerSSE(url='http://localhost:43832/sse#github')

# For Streamable HTTP
server = MCPServerStreamableHTTP(url='http://localhost:51712/mcp')
```

### Example: Continue

For the [Continue](https://continue.dev) extension in VS Code or JetBrains, edit
your `~/.continue/config.yaml` file or project-specific
`.continue/mcpServers/<name>.yaml` file to include the MCP server URL:

```yaml
mcpServers:
- name: fetch
type: sse
url: http://localhost:43832/sse#fetch
```

Continue supports SSE (`type: sse`) and Streamable HTTP
(`type: streamable-http`) transports.

### Example: Copilot for JetBrains IDEs

For the
Expand All @@ -258,8 +271,8 @@ to include the MCP server URL:
```json
{
"servers": {
"fetch": { "url": "http://localhost:43832/sse#fetch", "type": "sse" },
"osv": { "url": "http://localhost:51712/mcp", "type": "http" }
"github": { "url": "http://localhost:43832/sse#github", "type": "sse" },
"fetch": { "url": "http://localhost:51712/mcp", "type": "http" }
}
}
```
Expand Down