Skip to content
appsgit

Fitter

Fitter is an MCP server that turns any website or API into structured JSON with LLM-authored declarative scraping configs. It has 133 GitHub stars, is released under the MIT license and runs locally with docker run -i --rm -e FITTER_PLUGINS ghcr.io/pxyup/fitter-mcp:v1.8.3.

github.com/PxyUp/fitter (opens in a new tab)

Install Fitter

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "fitter": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "FITTER_PLUGINS",
        "ghcr.io/pxyup/fitter-mcp:v1.8.3"
      ],
      "env": {
        "FITTER_PLUGINS": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env FITTER_PLUGINS=your-value --transport stdio fitter -- docker run -i --rm -e FITTER_PLUGINS ghcr.io/pxyup/fitter-mcp:v1.8.3

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "fitter": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "FITTER_PLUGINS",
        "ghcr.io/pxyup/fitter-mcp:v1.8.3"
      ],
      "env": {
        "FITTER_PLUGINS": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "servers": {
    "fitter": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "FITTER_PLUGINS",
        "ghcr.io/pxyup/fitter-mcp:v1.8.3"
      ],
      "env": {
        "FITTER_PLUGINS": "your-value"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
FITTER_PLUGINSNoOptional path to a fitter plugins folder

Tools (6)

Parsed from the Tools section of the README; check the repository for the current list.

  • fitter_run

    Run a Fitter config passed inline (JSON or YAML string) and return the extracted data as JSON.

  • fitter_run_file

    Same as fitterrun but reads the config from a local .json/.yaml file

  • fitter_run_url

    Same as fitterrun but downloads the config from an HTTP(S) URL, e.g. a raw GitHub link

  • fitter_inspect_url

    Fetch a URL and return a compact structure outline + candidate selectors/paths (gjson paths for JSON;…

  • fitter_validate_config

    Validate a config without executing it (structure, responsetype, connector data source, model).

  • fitter_config_reference

    Return a condensed reference of the whole config format (connectors, parsers, model/field schema, placeholders,…

About Fitter

Fitter turns any website or API into structured JSON — declaratively. One JSON/YAML config describes where the data lives (HTTP request, headless browser, file, static value) and what to extract (JSON paths, CSS selectors, XPath). No code, no brittle scraping scripts.

  • api
  • go
  • parsing
  • scraper
  • scrawler
  • golang
  • json
  • ai-agents
  • mcp
  • mcp-server

FAQ

Fitter FAQ

Still curious? Email info@appsgit.com.

What is Fitter?

Fitter is an MCP server that turns any website or API into structured JSON with LLM-authored declarative scraping configs. It has 133 GitHub stars, is released under the MIT license and runs locally with docker run -i --rm -e FITTER_PLUGINS ghcr.io/pxyup/fitter-mcp:v1.8.3. The source code is at github.com/PxyUp/fitter.

How do I install the Fitter MCP server?

Add the command docker run -i --rm -e FITTER_PLUGINS ghcr.io/pxyup/fitter-mcp:v1.8.3 to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Fitter free?

The server is open source under the MIT license, so running it is free. It does not declare any required API key.

Is Fitter actively maintained?

The most recent commit was on Aug 26, 2026. The latest release is v1.8.3, published Aug 26, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.