# Connect an MCP client to Toolfound: setup for every client

Point Claude Code, Cursor, VS Code, Windsurf or Zed at the Toolfound MCP endpoint, or call it with plain HTTP. Config snippets for each client.

For agents: the documentation index is at [/llms.txt](https://toolfound.com/llms.txt) and this page is available as markdown at [/mcp/setup.md](https://toolfound.com/mcp/setup.md). HTML version: https://toolfound.com/mcp/setup

The Toolfound MCP server is a remote server over streamable HTTP at https://toolfound.com/api/mcp. There is nothing to install and no key to create for the read tools. Any client that speaks MCP over streamable HTTP can connect with the endpoint alone.

## JSON config

Clients that read an mcpServers block take this entry.

```
{
  "mcpServers": {
    "toolfound": {
      "type": "http",
      "url": "https://toolfound.com/api/mcp"
    }
  }
}
```

## Command line

Clients that only support stdio can bridge the endpoint with mcp-remote.

```
# Any client that speaks MCP over streamable HTTP
# can connect with the endpoint alone:
https://toolfound.com/api/mcp

# For clients that only support stdio, bridge it:
npx -y mcp-remote https://toolfound.com/api/mcp
```

## Raw HTTP

No client is needed to try a tool. Send one JSON-RPC request with a content-type of application/json and an accept header that lists both application/json and text/event-stream.

```
curl -sS https://toolfound.com/api/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "toolfound_search_tools",
      "arguments": { "query": "invoicing", "limit": 5 }
    }
  }'
```

## Where the config file lives

Claude Code

`claude mcp add --transport http toolfound https://toolfound.com/api/mcp`

Cursor

`~/.cursor/mcp.json`

VS Code

`.vscode/mcp.json in the workspace`

Windsurf

`~/.codeium/windsurf/mcp_config.json`

Zed

`settings.json → context_servers`

## A real example

This request searches the index for invoicing tools. The response is a JSON-RPC result whose first content item is the JSON text shown below, trimmed here to its first result.

```
curl -sS https://toolfound.com/api/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "toolfound_search_tools",
      "arguments": { "query": "invoicing", "limit": 2 }
    }
  }'
```

```
{
  "ok": true,
  "query": "invoicing",
  "result_count": 2,
  "results": [
    {
      "slug": "pocket-invoice",
      "name": "Pocket Invoice",
      "tagline": "Free invoicing and PDF business documents, with a free MCP server for AI assistants.",
      "listing_url": "https://toolfound.com/tool/pocket-invoice",
      "pricing_model": "free",
      "votes": 0,
      "status": "launched",
      "launch_date": "2026-11-07T00:00:00.000Z",
      "for_sale": false
    }
  ]
}
```

## Other MCP documentation

- [Overview](https://toolfound.com/mcp.md)
- [Directory tools](https://toolfound.com/mcp/tools/directory.md)
- [Launch preparation tools](https://toolfound.com/mcp/tools/launch-prep.md)
- [Write tools](https://toolfound.com/mcp/tools/write.md)
- [Security](https://toolfound.com/mcp/security.md)
- [FAQ](https://toolfound.com/mcp/faq.md)