VS Code integration

Copilot's agent, with a browser of its own.

One command adds UnblockingAPI's hosted MCP server to VS Code. Sign in on first use, and GitHub Copilot's agent mode reads pages that normally refuse automated tools - rendered, or as JSON where a template covers the site.

500 free credits  ·  1 credit per successful fetch  ·  Open-source MCP server

VS Code · hosted MCP server

Server URL

https://mcp.unblockingapi.com/mcp
  1. 1Run code --add-mcp below, or add the URL with MCP: Add Server → HTTP
  2. 2Start the server; a browser opens to sign in
  3. 3Allow access, then use it from Copilot's Agent mode

The app never sees your API key. Disconnect it any time under Connected apps.

Current docs, not memory

Copilot reads the API reference and changelog as they are today, not as they were in training.

Pages that refuse bots

Residential proxies and a real browser get past bot walls and CAPTCHAs that stop a plain request.

Every workspace

Added to your user profile once, available in every folder you open.

Copilot's agent mode can call tools, but its own fetch stalls on pages that render with JavaScript or sit behind bot protection. UnblockingAPI's unblock_fetch takes a plain fetch first and a real browser when the site needs one, learned per site.

Where a site has a published template, find_templates finds it and Copilot gets clean JSON fields instead of a page of markup.

Add it to VS Code

Hosted server: one command, then sign in

RecommendedSign in, no key

Paste the hosted URL and approve access. No key to copy, nothing to install.

code --add-mcp '{"name":"unblockingapi","type":"http","url":"https://mcp.unblockingapi.com/mcp"}'

Or run MCP: Add Server from the Command Palette, choose HTTP and paste https://mcp.unblockingapi.com/mcp. The JSON it writes:

{
  "servers": {
    "unblockingapi": {
      "type": "http",
      "url": "https://mcp.unblockingapi.com/mcp"
    }
  }
}

On first connection VS Code opens a browser: sign in to UnblockingAPI and allow access.

Hosted server with an API key

URL + API key

Same hosted URL, authenticated by your key in a header.

.vscode/mcp.json

{
  "servers": {
    "unblockingapi": {
      "type": "http",
      "url": "https://mcp.unblockingapi.com/mcp",
      "headers": { "Authorization": "Bearer ${input:unblockingapi-key}" }
    }
  },
  "inputs": [
    { "id": "unblockingapi-key", "type": "promptString", "description": "UnblockingAPI key", "password": true }
  ]
}
VS Code prompts for the key once and keeps it out of the file.

Run it locally

Local server

Prefer to run the server yourself? It is open source and runs with npx (Node.js 18+).

code --add-mcp '{"name":"unblockingapi","type":"stdio","command":"npx","args":["-y","@unblockingapi/mcp"],"env":{"UNBLOCKINGAPI_KEY":"your_api_key_here"}}'

Try it in VS Code

Ask this once you're connected. VS Code should find the idealista template with find_templates and come back with parsed results instead of HTML.
Use unblockingapi to get the listings on https://www.idealista.com/venta-viviendas/estepona-malaga/ as structured data, then summarise the three cheapest.

VS Code questions

code --add-mcp writes to your user profile, so the server is available in every workspace. For one project, put the JSON in .vscode/mcp.json. VS Code's format uses a top-level servers object, not mcpServers.

Switch Copilot Chat to Agent mode and the UnblockingAPI tools appear under the tools picker. Ask it to read a page, or name the server ("use unblockingapi to…").

Not when you sign in. VS Code gets an access token for the hosted server, and the server uses your key on its behalf, so the key itself never leaves UnblockingAPI. You can disconnect any time under Connected apps. If you connect with an API key header instead, the key is stored in VS Code's own config.

The MCP server is free and open source. Fetches run on your UnblockingAPI account: every successful fetch costs 1 credit and failed ones are free. New accounts get 500 free credits with no credit card, and bigger credit packs add bonus credits. Looking up templates is free.

Three, all read-only. unblock_fetch reads any URL through our proxy network (residential and mobile connections where a site needs them) and a real browser, picking a plain fetch or a browser per site by itself. It returns the page as Markdown (HTML on request), or JSON with a template. find_templates checks whether a published template covers a site. get_build_guide gives VS Code the API reference and app guides when you build an app on the API. Details on the MCP server page.

The hosted server: nothing to install or update, and most apps sign in without a key. Run it locally with npx -y @unblockingapi/mcp if you prefer to keep the process on your machine - the tools and costs are the same.

Give VS Code a real browser.

500 free credits, no credit card. Connect in under a minute.