> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langsearch.com/llms.txt
> Use this file to discover all available pages before exploring further.
# LangSearch MCP
> Connect your tools to the web through the official LangSearch MCP server.
The hosted MCP server lets compatible agents use LangSearch without a custom HTTP integration.
## Choose your client
Replace `YOUR_LANGSEARCH_API_KEY` before connecting. Merge the configuration into the existing file rather than replacing other servers. For Codex, keep the key available in the environment where you launch the client.
**Terminal**
```bash theme={null}
export LANGSEARCH_API_KEY="YOUR_LANGSEARCH_API_KEY"
codex mcp add langsearch --url https://mcp.langsearch.com/mcp --bearer-token-env-var LANGSEARCH_API_KEY
```
**Terminal**
```bash theme={null}
claude mcp add --transport http langsearch https://mcp.langsearch.com/mcp \
--scope user \
--header "Authorization: Bearer YOUR_LANGSEARCH_API_KEY"
```
**.cursor/mcp.json**
```json theme={null}
{
"mcpServers": {
"langsearch": {
"url": "https://mcp.langsearch.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_LANGSEARCH_API_KEY"
}
}
}
}
```
**MCP: Open User Configuration, or workspace .vscode/mcp.json**
```json theme={null}
{
"servers": {
"langsearch": {
"type": "http",
"url": "https://mcp.langsearch.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_LANGSEARCH_API_KEY"
}
}
}
}
```
**.gemini/settings.json**
```json theme={null}
{
"mcpServers": {
"langsearch": {
"httpUrl": "https://mcp.langsearch.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_LANGSEARCH_API_KEY"
}
}
}
}
```
**opencode.json**
```json theme={null}
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"langsearch": {
"type": "remote",
"url": "https://mcp.langsearch.com/mcp",
"enabled": true,
"oauth": false,
"headers": {
"Authorization": "Bearer YOUR_LANGSEARCH_API_KEY"
}
}
}
}
```
**\~/.codeium/mcp\_config.json**
```json theme={null}
{
"mcpServers": {
"langsearch": {
"serverUrl": "https://mcp.langsearch.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_LANGSEARCH_API_KEY"
}
}
}
}
```
**MCP Servers → Configure MCP Servers**
```json theme={null}
{
"mcpServers": {
"langsearch": {
"type": "streamableHttp",
"url": "https://mcp.langsearch.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_LANGSEARCH_API_KEY"
},
"disabled": false,
"autoApprove": []
}
}
}
```
**.roo/mcp.json**
```json theme={null}
{
"mcpServers": {
"langsearch": {
"type": "streamable-http",
"url": "https://mcp.langsearch.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_LANGSEARCH_API_KEY"
}
}
}
}
```
**Zed settings.json**
```json theme={null}
{
"context_servers": {
"langsearch": {
"url": "https://mcp.langsearch.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_LANGSEARCH_API_KEY"
}
}
}
}
```
## Verify the connection
1. Save the configuration or run the command in your installed client.
2. Start or reload the LangSearch MCP connection and complete any client trust prompt.
3. Check that the client lists the server's tools.
4. Ask your agent to search the web for a specific topic and include source links.
## Troubleshooting
* **Unauthorized:** check the API key and the `Authorization: Bearer ...` header.
* **No tools listed:** confirm the endpoint ends in `/mcp`, then restart the connection and inspect the client log.
* **Rate limited:** check account usage. Creating another connection does not create another allowance.
Client settings differ: VS Code uses `servers`, Cursor uses `mcpServers`, and other clients may use different fields. Keep the format for your selected client.
Prefer installation instructions for your agent? Use the [Agent Skill](/integrations/skill).