Skip to content
MCP server

web2mcp

Cloudflare Worker gateway that turns REST APIs and web pages into MCP tools

Install
Pricing
Free
Platforms
API, CLI, self-hosted
Runs
Remotely
Version
0.2.0
Listing updated
3 days ago

About web2mcp

web2mcp is a free MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://web2mcp.cwei59969.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "web2mcp": {
      "url": "https://web2mcp.cwei59969.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free

Free; runs on the Cloudflare Workers free plan

Prices change. Check web2mcp.cwei59969.workers.dev before you buy.

web2mcp 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 to web2mcp

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools