WebUplink — Claude Code MCP server: what it does, how to install
Connects WebUplink browser sessions to your AI client to inspect sites and run page actions through API calls.
claude mcp add mcp -e WEBUPLINK_API_KEY=<WEBUPLINK_API_KEY> -- npx -y @webuplink/mcpWhat WebUplink does
This server supplies your client with tools to control browser sessions directly. It defines two methods: browse to navigate to links or trigger actions on existing tabs, and close_session to free allocated resources when browsing completes.
Execution happens over stdio via npx or as a background HTTP daemon using webuplink-mcp-http. The HTTP endpoint receives requests at /mcp on 127.0.0.1:3001 out of the box. Binding to external interfaces requires filling MCP_HTTP_ALLOWED_HOSTS to safeguard against unauthorized origins.
A valid WEBUPLINK_API_KEY token is mandatory, as the server cannot perform actions without it.
What it helps with
- fetch remote pages and inspect their contents in conversation
- trigger actions inside an active browser session
- shut down stale sessions to preserve memory
- expose browser tooling over a dedicated local HTTP endpoint
Example prompts for the agent
- Load the target page using browse and retrieve its text content.
- Send a tool action to the active tab using our current session_id.
- Shut down session sess_987 with close_session to clean up.
How to install WebUplink
Platform CLI
claude mcp add mcp -e WEBUPLINK_API_KEY=<WEBUPLINK_API_KEY> -- npx -y @webuplink/mcpReplace <…> with your own values
Platform CLI
codex mcp add webuplink --env WEBUPLINK_API_KEY=<WEBUPLINK_API_KEY> -- npx -y @webuplink/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"webuplink": {
"command": "npx",
"args": [
"-y",
"@webuplink/mcp"
],
"env": {
"WEBUPLINK_API_KEY": "<WEBUPLINK_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"webuplink": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@webuplink/mcp"
],
"env": {
"WEBUPLINK_API_KEY": "<WEBUPLINK_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e WEBUPLINK_API_KEY=<WEBUPLINK_API_KEY> webuplink npx -y @webuplink/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about WebUplink
How do I install WebUplink in Claude Code?
Run claude mcp add --env WEBUPLINK_API_KEY=<WEBUPLINK_API_KEY> --transport stdio webuplink -- npx -y @webuplink/mcp with your actual API key.
What does the browse tool do?
It launches a browsing session for a target URL or triggers designated page-level tools, returning document contents back to the assistant.
Which environment variables are required?
The service requires WEBUPLINK_API_KEY to authenticate. For local HTTP transport, you can optionally configure PORT, MCP_HTTP_HOST, and MCP_HTTP_ALLOWED_HOSTS.
