Skip to content
MCP server

UAParse

Parse a User-Agent string and flag bots, search crawlers, AI crawlers and AI agents

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
0.5.3
Listing updated
2 days ago

About UAParse

UAParse is a freemium MCP server for analytics and data. It runs as a hosted remote server, so there is nothing to install locally.

UAParse reads a User-Agent string and returns browser, OS, device type and engine, then labels whether it belongs to a known bot, search crawler, AI crawler or an AI agent acting for a user. Browser details come from ua-parser-js 1.0.41, while bot matching uses a curated list of 151 known bots, 43 of them AI crawlers, with the first matching token winning.

For AI crawlers it adds a purpose label where the operator documents one: training, search, user_fetch or agent. Nine names, including ChatGPT-User, Claude-User and Perplexity-User, are flagged as is_ai_agent. The site cautions that matches are never verified, since a User-Agent can be spoofed and no DNS or IP checks are done.

The MCP tool is parse_user_agent. Without a key, about 20 lookups a minute are allowed; bulk parsing needs a key and stays in the JSON API.

Install

Run in a terminal

claude mcp add --transport http uaparse https://uaparse.mike-tusa.workers.dev/mcp

Add to Settings → Connectors → Add custom connector

https://uaparse.mike-tusa.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "uaparse": {
      "url": "https://uaparse.mike-tusa.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "uaparse": {
      "type": "http",
      "url": "https://uaparse.mike-tusa.workers.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "uaparse": {
      "serverUrl": "https://uaparse.mike-tusa.workers.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "uaparse": {
      "type": "http",
      "url": "https://uaparse.mike-tusa.workers.dev/mcp"
    }
  }
}

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

parse_user_agent
Parses a User-Agent string and flags bots, crawlers and AI agents.

What it does

Browser, OS and device
Returns browser, OS, device type and engine.
Bot and crawler flags
Matches 151 known bots, 43 of them AI crawlers.
AI purpose labels
Labels training, search, user_fetch or agent where documented.
AI agent detection
Flags nine user-triggered fetcher names as AI agents.
No external calls
Runs entirely inside the Worker without DNS or IP lookups.

Good for

  • Identify which crawler in server logs is an AI trainer
  • Decide how to treat AI agent traffic on a site
  • Segment analytics by browser and device
  • Check a suspicious User-Agent from an agent chat

Pricing

Freemium, from $5 a month

Free about 20 lookups/min; free key 1,000/day; Pro $5/month for 10,000/day

Prices change. Check uaparse.mike-tusa.workers.dev before you buy.

UAParse FAQ

Is a match verified?

No. UAParse does no DNS or IP checks, so anyone can spoof a User-Agent.

What does Pro cost?

$5 a month for 10,000 lookups per UTC day and bulk parsing up to 100 User-Agents per call.

Does it build robots.txt rules?

No. The site points to a sibling product, RobotsGate, for that.

Is bulk parsing available over MCP?

No. Bulk parsing stays in the JSON API and needs a key.

Is UAParse free?

UAParse has a free plan, with paid plans for more usage or features. Paid plans start at $5 a month.

How do I add UAParse to Claude Code?

Run this command in your terminal: claude mcp add --transport http uaparse https://uaparse.mike-tusa.workers.dev/mcp

What are the best alternatives to UAParse?

The closest alternatives to UAParse are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to UAParse

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data