@anakin-io/mcp

Model Context Protocol server for Anakin.

Gives AI agents in Claude Desktop, Cursor, Windsurf, VS Code, and any other MCP-compatible client native access to web scraping, search, crawling, mapping, agentic research, and Wire actions — without writing any glue code.

Status: alpha (v0.1.x). Tool surface and arguments may change between minor versions until v1.0.

Quick install (recommended)

One command configures every detected agent client:

npx -y @anakin-io/mcp@latest init --all

You'll be prompted for your API key (or set ANAKIN_API_KEY first to skip the prompt). Get one free at anakin.io/dashboard — 500 credits, no card required.

After it finishes, restart your agent client(s). The anakin MCP server will appear in the tool list, exposing the tools below.

Manual install

If you prefer to edit config files yourself, see Manual setup per client.

What's exposed

| Tool | Purpose | |---|---| | scrape | Fetch one URL → markdown (or AI-extracted JSON with generateJson: true). | | search | AI web search with citations. Synchronous. | | map | Discover all URLs on a domain. | | crawl | Bulk-fetch markdown across a site. | | agentic_search | Multi-source deep research (1–5 min). | | wire_discover | Find a Wire action for a task by natural-language intent. | | wire_catalog | Browse supported sites and a site's actions + param schemas. | | wire_read_action | Run a Wire read action (extracts data, no state change). | | wire_write_action | Run a Wire write action (state-changing; never payments). | | wire_identities | List saved accounts/credentials for auth-required actions. | | wire_login | Sign in to a credentials-mode site → credential_id. | | wire_build | Request a brand-new action for a site not yet in the catalog. | | monitor_create | Watch a page/site/Wire action on a schedule; alert on change. | | monitor_list | List your monitors (or fetch one by id). | | monitor_changes | Detected changes for a monitor. | | monitor_control | Pause / resume / run-now / delete a monitor. | | ai_visibility_search | Ask ChatGPT/Gemini/Google AI Overview the same question, compare answers. | | ai_visibility_sources | List available AI answer engines. | | session_list | List saved browser login sessions (ids for sessionId params). | | session_delete | Permanently delete a saved session. | | browser_task | Natural-language task in an AI-driven cloud browser (up to ~5 min). |

Wire runs pre-built automation actions across hundreds of sites. Actions are read (extract listings, category products, prices, reviews, profiles, dashboard metrics) or write (log in, submit a form) — many read actions need no auth. The loop is: wire_discover (or wire_catalog) to find an action_id and its type, then wire_read_action or wire_write_action (matching the type) to run it; add a credential_id only when the action's auth mode is required. Payment execution and fund transfers are refused by policy.

Each tool is a thin wrapper around the Anakin REST API — there is no scraping logic in this package, just MCP-protocol glue. The HTTP client is self-contained (src/client.ts); no runtime dependency on the @anakin-io/sdk Node SDK.

Updating

Configs created by this package pin @anakin-io/mcp@latest, so updates are automatic — every time your client launches the server, npx runs the newest published version. Just restart your client to pick up a release.

Already set up before v0.1.4? Your config likely uses an unpinned @anakin-io/mcp, which npx keeps serving from cache. Run this once to switch it to auto-updating — it keeps your API key and never prompts:

npx -y @anakin-io/mcp@latest update

Then restart your client. Confirm the version with:

npx -y @anakin-io/mcp@latest --version

Manual setup per client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "anakin": {
      "command": "npx",
      "args": ["-y", "@anakin-io/mcp@latest"],
      "env": {
        "ANAKIN_API_KEY": "ak-..."
      }
    }
  }
}

Restart Claude Desktop.

Claude Code (Anthropic CLI)

Edit ~/.claude/settings.json:

{
  "mcpServers": {
    "anakin": {
      "command": "npx",
      "args": ["-y", "@anakin-io/mcp@latest"],
      "env": {
        "ANAKIN_API_KEY": "ak-..."
      }
    }
  }
}

Or use Claude Code's built-in command:

claude mcp add anakin npx -y @anakin-io/mcp@latest -e ANAKIN_API_KEY=ak-...

Cursor

Edit ~/.cursor/mcp.json (user-scoped) or ./.cursor/mcp.json (project-scoped):

{
  "mcpServers": {
    "anakin": {
      "command": "npx",
      "args": ["-y", "@anakin-io/mcp@latest"],
      "env": {
        "ANAKIN_API_KEY": "ak-..."
      }
    }
  }
}

Restart Cursor.

Cline (VS Code extension — "Claude Dev")

Edit Cline's settings file inside VS Code's globalStorage:

| Platform | Path | |---|---| | macOS | ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json | | Linux | ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json | | Windows | %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json |

{
  "mcpServers": {
    "anakin": {
      "command": "npx",
      "args": ["-y", "@anakin-io/mcp@latest"],
      "env": {
        "ANAKIN_API_KEY": "ak-..."
      }
    }
  }
}

Reload the Cline VS Code extension (or restart VS Code).

Continue (IDE extension)

Edit ~/.continue/config.json:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "name": "anakin",
        "command": "npx",
        "args": ["-y", "@anakin-io/mcp@latest"],
        "env": {
          "ANAKIN_API_KEY": "ak-..."
        }
      }
    ]
  }
}

If you have other entries under experimental.modelContextProtocolServers, append the anakin object to the existing array — don't overwrite. Reload the Continue extension.

Zed

Edit ~/.config/zed/settings.json (macOS / Linux) or %APPDATA%/Zed/settings.json (Windows):

{
  "context_servers": {
    "anakin": {
      "command": "npx",
      "args": ["-y", "@anakin-io/mcp@latest"],
      "env": {
        "ANAKIN_API_KEY": "ak-..."
      }
    }
  }
}

Reload Zed.

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "anakin": {
      "command": "npx",
      "args": ["-y", "@anakin-io/mcp@latest"],
      "env": {
        "ANAKIN_API_KEY": "ak-..."
      }
    }
  }
}

Restart Windsurf.

VS Code (with the MCP extension)

Edit .vscode/mcp.json in your workspace:

{
  "servers": {
    "anakin": {
      "command": "npx",
      "args": ["-y", "@anakin-io/mcp@latest"],
      "env": {
        "ANAKIN_API_KEY": "ak-..."
      }
    }
  }
}

Reload VS Code.

Verify it's working

In Claude Desktop / Cursor / etc., ask the agent something like:

Scrape https://example.com using anakin and return the markdown.

The agent should call the scrape tool, return the page contents, and cite the call in its trace.

CLI reference

anakin-mcp                       Run the MCP server (default — clients spawn this).
anakin-mcp init                  Interactive client config.
anakin-mcp init --all            Configure every detected client, no prompts.
anakin-mcp init --client=cursor  Only configure one client.
anakin-mcp --version             Print version.
anakin-mcp --help                Print usage.

How agents discover Anakin

Two complementary paths:

1. MCP (this package) — for clients that support it. Tools are typed and called natively. This is the high-quality path.
2. SKILL.md — for any agent that can fetch a URL. The markdown describes the API end-to-end so an agent can use it via plain HTTP calls.

Most users on Claude Desktop / Cursor / Windsurf / VS Code will want option 1.

Development

git clone https://github.com/Anakin-Inc/anakin-mcp.git
cd anakin-mcp
npm install
npm run build
ANAKIN_API_KEY=ak-... node dist/cli.js  # smoke-test the server

For local end-to-end testing with an actual MCP client, point the client at the absolute path of dist/cli.js:

{
  "mcpServers": {
    "anakin-dev": {
      "command": "node",
      "args": ["/absolute/path/to/anakin-mcp/dist/cli.js"],
      "env": { "ANAKIN_API_KEY": "ak-..." }
    }
  }
}

Related

• @anakin-io/sdk — Node.js / TypeScript SDK
• anakin — Python SDK
• anakin-cli — Python CLI for human terminal use
• SKILL.md — agent-onboarding doc for non-MCP agents

License

Apache 2.0