Getting Started

Web2MCP Quickstart Guide

Web2MCP transforms human-facing websites, web applications, and internal portals into live, verified Model Context Protocol (MCP) endpoints for Cursor, Claude, VS Code, and autonomous AI agents.

How to generate your first MCP server in 3 steps:

Try via Web2MCP CLI

npx web2mcp add https://news.ycombinator.com

Under The Hood

System Architecture

Web2MCP replaces brittle handwritten web scrapers with an end-to-end autonomous discovery and protocol synthesis pipeline.

// Web2MCP Execution Pipeline:

1. Crawler Engine: TinyFish SDK + Cheerio Fallback Driver navigates SPA/HTML, extracts forms, inputs, and catalogs.

↓

2. Schema Inference: Synthesizes JSON Schema parameter models and filters out non-functional fields.

↓

3. Safety Gate: Classifies risk levels (read_only vs consequential actions like bookings or payments).

↓

4. Evidence Vault: Runs synthetic probes, records DOM hash, validates responses, and assigns health scores.

↓

5. Streamable MCP Server: Standard JSON-RPC 2.0 endpoint ready for Cursor, Claude, and VS Code.

Setup

Connecting to AI Clients & IDEs

Connect your generated MCP server to your favorite coding assistant in less than 30 seconds.

Cursor IDE Configuration

Open Cursor Settings > Features > MCP and add your server as an HTTP server, or paste into ~/.cursor/mcp.json:

{
  "mcpServers": {
    "web2mcp-server": {
      "url": "https://web2mcp.ssh.net.in/api/mcp/YOUR_PROJECT_ID/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code CLI

Run this command directly in your terminal:

claude mcp add --transport http web2mcp https://web2mcp.ssh.net.in/api/mcp/YOUR_PROJECT_ID/mcp

Claude Desktop

Add the stdio bridge runner to claude_desktop_config.json:

{
  "mcpServers": {
    "web2mcp": {
      "command": "npx",
      "args": ["-y", "web2mcp", "serve", "YOUR_PROJECT_ID"]
    }
  }
}

Standards

Streamable HTTP & JSON-RPC 2.0 Protocol

All Web2MCP endpoints implement standard Model Context Protocol (2024-11-05 & 2025-11-25 specifications).

Supported Methods

Method	Description	Sample Parameters
initialize	Handshake returning server capabilities & tools list support	{ protocolVersion: '2024-11-05' }
tools/list	Returns array of all verified tools with typed JSON schemas	{}
tools/call	Executes tool action, runs validation probe & logs evidence	{ name: 'search_news', arguments: { query: 'ai' } }

Security

Safety Gate & Consequential Actions

Protect users from unintended mutations, bookings, or financial transactions.

CLI Tools

Standalone CLI Reference

Use web2mcp directly from your terminal or CI/CD pipelines.