# Figranium MCP

Wires your agent into a Figranium instance so browser automation Tasks can be created, run and scheduled without touching the API by hand.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: figranium
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/figranium/figranium-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/figranium-mcp

## What it does

Figranium stores website workflows as reusable Tasks. This package is the local STDIO client that exposes them to an agent through tools: `task_list`, `create_task`, `task_execute`, `execution_list`, plus the `schedule_*` group for timers. A resource at `figranium://schemas/task-v1.json` lets a client read the Task schema.

You need a Figranium instance already running and an API key taken from its settings. Leave `FIGRANIUM_API_KEY` out and the process stops with a setup message instead of starting. The default target is `http://localhost:11345`; point `FIGRANIUM_BASE_URL` elsewhere for a different host. When the server itself lives in Docker but Figranium stays on the host, swap in `http://host.docker.internal:11345`.

Bad Task payloads come back with structured validation diagnostics, so the agent can fix its own request. Figranium's instructions cover Task construction, selector choice, variables and sequencing. Clients that speak remote OAuth can use the hosted endpoint `https://mcp.figranium.dev/mcp`, which reaches a publicly available instance.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add figranium-mcp -- npx -y figranium-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add figranium-mcp -- npx -y figranium-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "figranium-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "figranium-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "figranium-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "figranium-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add figranium-mcp npx -y figranium-mcp
```

## When to use it
- turn a chat description into a browser automation Task
- re-run an existing Task with different variable values
- check how earlier executions turned out
- put a Task on a schedule and read its state
- check the Task schema before sending a payload

## Example prompts
- List my Figranium tasks and run the one that scrapes prices from product pages
- Create a task that opens the login page, fills the credentials from variables and waits for the dashboard
- Schedule that task for every day at 9am and show me the schedule

## Similar
- [use-tinyfish](https://affpapa.org/en/nevibecode/skills/use-tinyfish.md) — skill · 3400 installs
- [autobrowse](https://affpapa.org/en/nevibecode/skills/autobrowse.md) — skill · 2800 installs
- [chrome-cdp-live-browser](https://affpapa.org/en/nevibecode/skills/chrome-cdp-live-browser.md) — skill · 1500 installs
- [qiaomu-opencli-browser](https://affpapa.org/en/nevibecode/skills/qiaomu-opencli-browser.md) — skill · 1100 installs
- [web-access-claude-skill](https://affpapa.org/en/nevibecode/skills/web-access-claude-skill.md) — skill · 965 installs
- [pinchtab](https://affpapa.org/en/nevibecode/skills/pinchtab.md) — skill · 892 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md