@tooltrace/mcp-server

ToolTrace MCP Server

Give AI agents a complete web intelligence toolkit. This Model Context Protocol server connects Claude Code, Claude Desktop, Cursor, VS Code, Codex, Windsurf and any other MCP client to the ToolTrace API.

One tool per ToolTrace endpoint: scrape any page to clean Markdown, read metadata and JSON-LD, extract links, run on-page SEO audits, detect a site's tech stack, and check XML sitemaps. Free tier included, no card required.

Setup guide: tooltrace.io/mcp

Tools

Tool	Description
tooltrace_extract	Extract clean Markdown, text, metadata, links, JSON-LD, and sections from any webpage
tooltrace_metadata	Get page title, description, canonical URL, Open Graph, and Twitter card fields
tooltrace_links	Extract all internal and external links with anchor text
tooltrace_schema	Extract JSON-LD structured data (Article, Product, FAQ, etc.)
tooltrace_seo_audit	Run an SEO audit with scored checks and recommendations
tooltrace_tech_stack	Detect CMS, frameworks, analytics, CDN, hosting, and more
tooltrace_sitemap	Inspect and parse XML sitemaps

Quick start

1. Get a free API key

Sign up at tooltrace.io/signup. The free plan includes 1,000 credits per month.

2. Install

npm install -g @tooltrace/mcp-server

3. Configure your MCP client

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tooltrace": {
      "command": "tooltrace-mcp",
      "env": {
        "TOOLTRACE_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code:

claude mcp add tooltrace tooltrace-mcp -e TOOLTRACE_API_KEY=your-api-key

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "tooltrace": {
      "command": "tooltrace-mcp",
      "env": {
        "TOOLTRACE_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "tooltrace": {
      "command": "tooltrace-mcp",
      "env": {
        "TOOLTRACE_API_KEY": "your-api-key"
      }
    }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.tooltrace]
command = "tooltrace-mcp"
env = { TOOLTRACE_API_KEY = "your-api-key" }

Windsurf (mcp_config.json):

{
  "mcpServers": {
    "tooltrace": {
      "command": "tooltrace-mcp",
      "env": {
        "TOOLTRACE_API_KEY": "your-api-key"
      }
    }
  }
}

Any other MCP client: run tooltrace-mcp over stdio and set the TOOLTRACE_API_KEY environment variable. Full per-client setup guide at tooltrace.io/mcp.

Run with npx (no install)

TOOLTRACE_API_KEY=your-api-key npx @tooltrace/mcp-server

Usage examples

Once connected, your AI agent can:

• "Extract the main content from this blog post as Markdown"
• "What technologies does competitor.com use?"
• "Run an SEO audit on our landing page"
• "Get all the links from this documentation page"
• "Extract the JSON-LD schema from this product page"
• "Check the sitemap for this website"

Rendering modes

All tools support a render parameter:

• never: Fast static fetch, 1 credit. Best for server-rendered pages.
• auto (default): Starts static, renders in browser if needed. 1 or 5 credits.
• always: Full browser rendering, 5 credits. For JavaScript-heavy SPAs.

Development

git clone https://github.com/ToolTrace-io/mcp-server.git
cd mcp-server
npm install
npm run build
TOOLTRACE_API_KEY=your-key node dist/index.js

License

MIT