Your browser, one command away

Use your real Chrome through any MCP client. No Playwright. No headless. Raw CDP over your existing agent.

1

Connect Your Browser

Checking agent status...

Install the Unchained agent on your Mac to bridge your local Chrome:

curl -fsSL https://api.unchainedsky.com/install.sh | bash
2

Add MCP Server

claude mcp add unchainedsky \
  https://api.unchainedsky.com/mcp \
  -t http \
  -H "Authorization: Bearer YOUR_API_KEY"

Restart Claude Code after adding (/mcp to verify tools are loaded).

3

Verify

Ask your MCP client to run a quick DDM extraction (agent_id is auto-detected from your API key):

ddm url=https://example.com

To check your agent connection status:

curl -s -H "Authorization: Bearer YOUR_API_KEY" https://api.unchainedsky.com/api/agents | python3 -m json.tool

Available MCP Tools

Extraction pipeline: ddm orients the page (~500 tokens) → intel_probe classifies the best extraction strategy → intel_extract pulls structured data. For JS-heavy SPAs, probe may rank intel_storesintel_shape / intel_find_pathsjs_eval higher.
ToolDescription
Page Understanding
ddmDOM Density Map — structural page layout + interactive elements (~500 tokens). Use --text for page text, --at x,y for element details, --find "keyword" to search.
intel_probePage intelligence probe — DOM fingerprint + Bayesian strategy ranking (~100 tokens). Run on first visit to any SPA.
intel_extractExtract structured data using auto-selected or forced strategy (host_attrs, react_fiber, data_testid, etc.)
Data Store Extraction
intel_storesList JavaScript data stores on page (globals >10KB). Use on Nuxt/Next/YouTube sites.
intel_shapeMap the shape of a JS global object (e.g. __NUXT__, ytInitialData).
intel_find_pathsFind paths to a key pattern inside a JS global.
Browser Interaction
cdp_navigateNavigate to a URL. Returns page title and DDM layout.
cdp_clickClick at pixel coordinates (from DDM output). Returns updated DDM layout.
cdp_typeType text into the focused element. Click an input first to focus it.
js_evalExecute JavaScript and return the result. Use for SPA widgets, querySelectorAll, data stores.
cdp_screenshotTake a screenshot (~2100 tokens). Prefer DDM. Use for CAPTCHAs/visual verification only.
File & Agent Management
cdp_set_fileSet a file on <input type="file"> without the OS picker.
list_connected_agentsList connected browser agents and Chrome profiles.
Chrome Profile Provisioning
cdp_provision_launchLaunch Chrome with a user profile for OAuth/authenticated browsing.
cdp_provision_cleanupClean up provisioned Chrome instances.
list_provisioned_tabsList tabs in provisioned Chrome (discover OAuth popups).