# mcp-server

Connect an AI agent to web-page extraction, SEO checks, technology detection, and sitemap inspection. Works with Claude Code and other MCP clients.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: ToolTrace-io
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ToolTrace-io/mcp-server
- Updated: 2026-09-08
- HTML: https://affpapa.org/en/nevibecode/mcp/tooltrace-io-mcp-server

## What it does

ToolTrace’s MCP server gives an agent access to page content in Markdown, metadata, links, and JSON-LD data. It can also run on-page SEO checks, identify a site’s technology stack, and parse XML sitemaps. The server uses the ToolTrace API for these tasks.

Choose an HTTP connection or run the server locally over stdio. Both options expose the same tools and use credits at the same rates. Local setup requires a ToolTrace API key in `TOOLTRACE_API_KEY`; without it, the server cannot call the API. The free plan includes 1,000 credits per month. For JavaScript-heavy pages, `always` triggers browser rendering and costs 5 credits.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.tooltrace.io/mcp`
- Environment variables: `TOOLTRACE_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add mcp-server -e TOOLTRACE_API_KEY=<TOOLTRACE_API_KEY> -- npx -y @tooltrace/mcp-server
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http tooltrace-io-mcp-server https://mcp.tooltrace.io/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add tooltrace-io-mcp-server --url https://mcp.tooltrace.io/mcp
```

2. **Platform CLI**
```bash
codex mcp add tooltrace-io-mcp-server --env TOOLTRACE_API_KEY=<TOOLTRACE_API_KEY> -- npx -y @tooltrace/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tooltrace-io-mcp-server": {
            "url": "https://mcp.tooltrace.io/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tooltrace-io-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@tooltrace/mcp-server"
            ],
            "env": {
                "TOOLTRACE_API_KEY": "<TOOLTRACE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tooltrace-io-mcp-server": {
            "type": "http",
            "url": "https://mcp.tooltrace.io/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tooltrace-io-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@tooltrace/mcp-server"
            ],
            "env": {
                "TOOLTRACE_API_KEY": "<TOOLTRACE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http tooltrace-io-mcp-server https://mcp.tooltrace.io/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e TOOLTRACE_API_KEY=<TOOLTRACE_API_KEY> tooltrace-io-mcp-server npx -y @tooltrace/mcp-server
```
Replace <…> with your own values

## When to use it
- extract a web page as Markdown
- run an SEO audit on a landing page
- identify a site's technologies
- collect links from a documentation page
- inspect a site's XML sitemap

## Example prompts
- Pull the main content from this page and return it as Markdown.
- Audit this landing page for on-page SEO issues.
- Inspect this site's sitemap and list the URLs it contains.

## Similar
- [competitor-profiling](https://affpapa.org/en/nevibecode/skills/competitor-profiling.md) — skill · 95100 installs
- [firecrawl-workflows](https://affpapa.org/en/nevibecode/skills/firecrawl-workflows.md) — skill · 32600 installs
- [Web Content & URL Tools](https://affpapa.org/en/nevibecode/mcp/web-content-url-tools.md) — MCP server
- [site-architecture](https://affpapa.org/en/nevibecode/skills/coreyhaines31-site-architecture.md) — skill · 123400 installs
- [docs-seo](https://affpapa.org/en/nevibecode/skills/docs-seo.md) — skill · 10000 installs
- [seo-sitemap](https://affpapa.org/en/nevibecode/skills/seo-sitemap.md) — skill · 7300 installs

## Other versions with the same name
- [mcp-server · heyputer](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — ★ 43929
- [mcp-server · mapbox](https://affpapa.org/en/nevibecode/mcp/mapbox-mcp-server.md) — ★ 363
- [mcp-server · packmindhub](https://affpapa.org/en/nevibecode/mcp/packmindhub-mcp-server.md) — ★ 319
- [mcp-server · bingowon](https://affpapa.org/en/nevibecode/mcp/bingowon-mcp-server.md) — ★ 121
- [mcp-server · ui5](https://affpapa.org/en/nevibecode/mcp/ui5-mcp-server.md) — ★ 105

---
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