Turn any webpage into a production-ready MCP connector — works with Claude, Cursor, Windsurf, and any MCP-compatible AI agent.
OpenConnect is an open (source-available) platform that lets anyone generate MCP (Model Context Protocol) connectors for any website using a Chrome extension and an AI-powered execution engine.
[Chrome Extension] → Generates connector JSON via AI → Pushes to Hub
↓ ↓
[Page Analyzer] → Playwright DOM steps [MCP Server]
↓ ↓
[AI Connector Arch.] → Tools with self-healing selectors → [SSE/Streamable]
↓
[Claude/Cursor/Windsurf]
- Chrome Extension (v1.4.0) — One-click connector generation from any page
- 3-Tier Generation — Free (baked key), Premium (server-side GPT-4o), Custom (BYOK)
- Execution Engine — Playwright-powered DOM automation with self-healing selectors
- 20+ DOM Step Actions — navigate, fill, click, extract, file upload/download, multi-tab, screenshots
- Gamification — Points, leaderboards, badges, daily caps, anti-gaming
- Auth System — Email/password, Google, GitHub, X OAuth, httpOnly cookies, JWT
- Hub Website — Landing page, connector directory, public profiles, changelog
- Dashboard SPA — User dashboard with connector management, credits, settings
- 18/22 Phases Complete — Core platform, execution engine, analytics, auth, gamification
OpenConnect/
├── extension/ # Chrome extension (MV3)
│ ├── background.js # Service worker: 3-tier generation, event tracking
│ ├── content.js # Page analyzer: DOM scanning, e-commerce detection
│ ├── content_sync.js # Dashboard ↔ extension token relay
│ ├── popup.html/js # Main UI: auth, tier selector, result card, library
│ ├── options.html/js # Settings: API key, model, storage
│ ├── styles.css # Extension styles
│ ├── manifest.json # MV3 manifest
│ └── icons/ # Extension icons (16, 48, 128px)
│
├── server/ # FastAPI backend + Playwright execution engine
│ ├── mcp_connector_server.py # Main server (v2.15.1) — 5880 lines
│ ├── billing.py # Tier-based quota tracking (starter/pro/unlimited)
│ ├── Dockerfile # Docker image with Playwright Chromium
│ ├── docker-compose.yml
│ ├── Caddyfile # Reverse proxy config (SSE support)
│ ├── deploy.sh # Hetzner VPS deploy script
│ ├── openconnect.service # Systemd service
│ ├── requirements.txt
│ ├── .env.example
│ ├── backup.sh
│ ├── data/ # Persistent JSON data (connectors, users, points)
│ └── tests/ # pytest suite (140 tests)
│ ├── conftest.py
│ ├── test_core.py
│ ├── test_auth_edge_cases.py
│ ├── test_integration.py
│ ├── test_phase1.py
│ └── test_phase2.py
│
├── web/ # Static sites (Cloudflare Pages)
│ ├── hub/ # Landing page (hub.dariocositore.com)
│ │ ├── index.html # Hero, connector directory, leaderboard
│ │ ├── connectors/ # Public connector directory
│ │ ├── docs/ # Documentation pages
│ │ ├── changelog/
│ │ ├── pricing/
│ │ ├── privacy/
│ │ ├── terms/
│ │ └── assets/ # CSS, JS, images
│ └── app/ # Dashboard SPA (app.dariocositore.com)
│ ├── index.html # Auth gate
│ ├── login.html # Login/register forms
│ ├── dashboard/ # Main dashboard (connectors, credits, points)
│ ├── auth/ # OAuth callback, email verification
│ ├── users/ # Public profiles
│ └── assets/ # CSS, JS (auth.js, app.js)
│
├── docs/ # Project documentation
│ ├── OpenConnect-Deployment-Guide.md
│ ├── EXECUTION-ENGINE.md
│ ├── GAMIFICATION.md
│ ├── RESUME.md
│ ├── REPO-GUIDE.md
│ └── plan.md
│
├── .github/ # GitHub config
│ ├── workflows/ # CI/CD
│ └── ISSUE_TEMPLATE/ # Bug report, feature request
│
├── LICENSE.md # Business Source License 1.1
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
├── SECURITY.md
└── README.md # This file
cd extension/
# Nothing to build — it's vanilla JS/HTML/CSS
# Go to chrome://extensions → Enable Developer mode → Load unpacked → Select this foldercd server/
cp .env.example .env
# Edit .env with your settings
pip install -r requirements.txt
python -m uvicorn mcp_connector_server:app --reload --port 8080cd server/
pip install -r requirements.txt pytest pytest-asyncio
python -m pytest tests/ -vcd server/
docker compose up --buildcd server/
bash deploy.sh your-domain.com| Endpoint | Method | Auth | Description |
|---|---|---|---|
/ |
GET | None | Health check |
{id}/sse |
GET | None | MCP tool definitions via SSE |
execute/{id}/{tool} |
POST | JWT | Execute a connector tool (Playwright) |
connectors |
POST | Admin | Create/update connector |
connectors |
GET | Admin | List all connectors |
connectors/public |
GET | None | Public connector list (with filters) |
connectors/public/{id} |
GET | None | Single connector detail |
connectors/push |
POST | None* | Push from extension (*email verified) |
connectors/generate |
POST | JWT | AI-powered premium generation |
auth/register |
POST | None | User registration |
auth/login |
POST | None | Login → httpOnly cookies |
auth/me |
GET | Cookie | Current user profile |
auth/logout |
POST | Cookie | Logout |
auth/forgot-password |
POST | None | Send reset email |
auth/reset-password |
POST | Token | Reset password |
auth/oauth/google |
Redirect | None | Google OAuth |
auth/oauth/twitter |
Redirect | None | X OAuth |
auth/oauth/github |
Redirect | None | GitHub OAuth |
leaderboard |
GET | None | Global rankings |
users/{id} |
GET | None | Public user profile |
users/{id}/badges |
GET | None | User badges |
points/balance |
GET | JWT | Current user points |
api/events |
POST | None | Analytics event tracking |
| Tier | Executions/Day | Price |
|---|---|---|
| Free | 10 | $0 |
| Starter | 500 | Waitlist |
| Pro | 1,500 | Waitlist |
| Unlimited | 5,000 | Waitlist |
Free tier gets 50 connector generations per account (baked-in OpenRouter key).
Connectors are JSON documents defining MCP tools with DOM automation steps:
{
"connector_id": "example-shopping",
"connector_name": "Example Shopping Assistant",
"description": "Search and browse products on example.com",
"session_mode": "stateless",
"tools": [{
"name": "example_search",
"description": "Search for products",
"inputSchema": {
"type": "object",
"properties": { "query": { "type": "string" } },
"required": ["query"]
},
"dom_steps": [
{ "action": "navigate", "url": "https://example.com/search?q={query}" },
{ "action": "wait_for_selector", "selector": ".results", "timeout_ms": 5000 },
{ "action": "extract", "selector": ".results", "as": "results" }
]
}]
}See CONTRIBUTING.md for guidelines. All contributors must sign the Contributor License Agreement (CLA) before their PRs can be merged.
This project is licensed under the Business Source License 1.1. You may use, modify, and contribute to this project for non-commercial purposes. On May 24, 2030, this license converts to Apache License 2.0.
Copyright 2026 Dario Cositore.