MCP Server Integration

CounterAgent provides an MCP server that exposes agent detection tools directly to LLM-powered applications. Compatible with Claude Desktop, Claude Code, Cursor, and any MCP-compatible client.

Server Discovery

MCP server manifest: /.well-known/mcp.json

Transport: Streamable HTTP at https://api.counteragent.io/mcp

Configuration

Claude Desktop / Claude Code

{
  "mcpServers": {
    "counteragent": {
      "url": "https://api.counteragent.io/mcp",
      "headers": {
        "Authorization": "Bearer ca_live_..."
      }
    }
  }
}

Cursor

{
  "mcp": {
    "servers": {
      "counteragent": {
        "url": "https://api.counteragent.io/mcp",
        "apiKey": "ca_live_..."
      }
    }
  }
}

Available Tools

detect_agent

Analyze a request to determine if it comes from an AI agent.

Use the detect_agent tool with:
- user_agent: "python-httpx/0.27.0"
- ja4: "t13d3514h2_bfa337485184_97a66a8f4cb1"

lookup_fingerprint

Look up any JA4/JA4S/JA4H/JA4X fingerprint in the database.

list_agents

Browse the full agent directory with filtering by category.

submit_fingerprint

Submit unrecognized fingerprints for analysis.

get_stats

Platform statistics and detection metrics.

Resources

MCP resources provide read access to the signature databases:

counteragent://signatures/ja4 — JA4 TLS fingerprint database
counteragent://signatures/ja4h — JA4H HTTP fingerprint database
counteragent://agents/directory — Full agent catalogue