# web2mcp

> web2mcp is a free MCP server for developer tools. Cloudflare Worker gateway that turns REST APIs and web pages into MCP tools. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI, self-hosted
- **Website:** https://web2mcp.cwei59969.workers.dev
- **Repository:** https://github.com/charleswei118/web2mcp
- **MCP Registry name:** io.github.charleswei118/web2mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

The README describes it as roughly 800 lines of dependency-free JavaScript that runs on the Cloudflare Workers free plan. You describe an HTTP API in about 15 lines of config, and it becomes a typed MCP tool that any client can call. An OpenAPI 3 spec can be converted into a connector with one command.

A public demo exposes 13 connectors and 16 tools with no API keys, including Wikipedia search and summaries, Hacker News front page and search, geocoding and weather, ECB exchange rates, GitHub repo search, npm package info and download counts, arXiv search, mainland China holiday calendars and Baidu hot searches. The demo is rate-limited, the GitHub tools often hit anonymous limits, and the reader and Bilibili tools are unavailable there.

For large APIs, catalog mode exposes just two tools, search_api and call_api. The README gives GitHub's 665 REST endpoints as an example, cutting tool definitions from about 147,000 tokens to about 300. It says it is not a fit for browser automation, logged-in scraping or OAuth on behalf of end users.

## Features

- **Config-based connectors:** Define an API's base URL, path and params instead of writing an MCP server.
- **Catalog mode:** Exposes a big API as two tools, search_api and call_api, to save context.
- **OpenAPI import:** Converts an OpenAPI 3 spec into a connector with one command.
- **Output trimming:** pick and fields options cut large JSON responses down for the model.
- **Host-locked requests:** Requests are restricted to each connector's host and arguments are type-checked.
- **Free hosting:** Deploys to the Cloudflare Workers free plan, or runs locally over stdio.

## Good for

- Give an agent access to a public REST API without writing a server
- Expose a very large API without flooding the context window
- Run a small self-hosted MCP gateway on Cloudflare's free tier
- Try the built-in Wikipedia, Hacker News and weather tools

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http web2mcp https://web2mcp.cwei59969.workers.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://web2mcp.cwei59969.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "web2mcp": {
      "url": "https://web2mcp.cwei59969.workers.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "web2mcp": {
      "type": "http",
      "url": "https://web2mcp.cwei59969.workers.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "web2mcp": {
      "serverUrl": "https://web2mcp.cwei59969.workers.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "web2mcp": {
      "type": "http",
      "url": "https://web2mcp.cwei59969.workers.dev/mcp"
    }
  }
}
```

## Tools

- `wikipedia_search`: Full-text search of English Wikipedia.
- `wikipedia_summary`: Lead summary of an English Wikipedia article by exact title.
- `hackernews_front_page`: Stories currently on the Hacker News front page.
- `hackernews_search`: Full-text search of Hacker News stories.
- `geocode_search`: Turn a place name into coordinates.
- `weather_forecast`: Current conditions and daily forecast for coordinates.
- `currency_latest`: Latest ECB reference exchange rates.
- `github_search_repos`: Search public GitHub repositories.
- `github_repo`: Metadata for one public GitHub repository.
- `npm_package`: Latest version, description and license of an npm package.
- `npmstats_downloads`: Last 7 days of npm downloads.
- `arxiv_search`: Search arXiv papers by keyword.
- `holidaycn_year`: Official holidays and make-up workdays in mainland China for a year.
- `baiduhot_realtime`: Current Baidu real-time hot search ranking.

## FAQ

### Is there a public demo?

Yes, at the /mcp path of the demo Worker. It is rate-limited and some tools are disabled there.

### What does catalog mode do?

It serves search_api and call_api instead of one tool per operation, which the README says reduces GitHub's tool definitions to about 300 tokens.

### Can I run it locally?

Yes, with npx -y github:charleswei118/web2mcp over stdio.

### What is it not for?

Browser automation, logged-in scraping, and OAuth on behalf of end users.

### Is web2mcp free?

Yes. web2mcp is free to use.

### How do I add web2mcp to Claude Code?

Run this command in your terminal: claude mcp add --transport http web2mcp https://web2mcp.cwei59969.workers.dev/mcp

### What are the best alternatives to web2mcp?

The closest alternatives to web2mcp are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/web2mcp
