ToolTrace MCP Server
OfficialToolTrace MCP Server gives AI agents a web intelligence toolkit through MCP, letting them scrape, analyze, and audit websites via ToolTrace's API.
Extract clean webpage content as Markdown, text, metadata, links, JSON-LD schema, and sections (
tooltrace_extract)Fetch page metadata like title, description, canonical URL, Open Graph, and Twitter cards (
tooltrace_metadata)Get all internal/external links with anchor text and normalized URLs (
tooltrace_links)Extract JSON-LD structured data such as Article, Product, FAQ, and BreadcrumbList (
tooltrace_schema)Run on-page SEO audits with scored checks and recommendations (
tooltrace_seo_audit)Detect a site's tech stack: CMS, frameworks, analytics, CDN, hosting, and more (
tooltrace_tech_stack)Inspect and parse XML sitemaps, discovering page URLs and metadata (
tooltrace_sitemap)Choose rendering modes (
never,auto,always) to handle static pages or JavaScript-heavy SPAsConnect via hosted HTTP endpoint or local stdio process across MCP clients like Claude, Cursor, VS Code, Codex, and Windsurf
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ToolTrace MCP Server Run an SEO audit on example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Extract clean Markdown, text, metadata, links, JSON-LD, and sections from any webpage |
| Get page title, description, canonical URL, Open Graph, and Twitter card fields |
| Extract all internal and external links with anchor text |
| Extract JSON-LD structured data (Article, Product, FAQ, etc.) |
| Run an SEO audit with scored checks and recommendations |
| Detect CMS, frameworks, analytics, CDN, hosting, and more |
| Inspect and parse XML sitemaps |
Related MCP server: mcp-web-search
Two ways to connect
Hosted, for clients that take a connector URL. Nothing to install or update:
https://mcp.tooltrace.io/mcpclaude mcp add --transport http tooltrace https://mcp.tooltrace.io/mcp \
--header "Authorization: Bearer your-api-key"Also listed on Smithery.
Local, over stdio, for clients that run a process. Use this when your client does not speak HTTP, or when you would rather your API key never left your own machine. That is the quick start below.
Both expose the same tools and bill the same credits.
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-server3. 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-keyCursor (.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-serverUsage 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.jsLicense
MIT
Available Tools
7 toolstooltrace_extractAInspect
Extract clean content from a webpage. Returns Markdown, plain text, metadata, links, JSON-LD schema, and content sections. Use this for scraping, RAG ingestion, or content analysis.
Inputs: url (required), mode, render, include, +2 more.
tooltrace_linksBInspect
Extract all links from a webpage with anchor text, internal/external classification, and normalized URLs.
Inputs: url (required), mode, render, wait_until, +1 more.
tooltrace_metadataAInspect
Extract page metadata: title, description, canonical URL, author, publication date, favicon, Open Graph, and Twitter card fields. Lightweight alternative to full extraction.
Inputs: url (required), render, wait_until, wait_for_selector.
tooltrace_schemaAInspect
Extract JSON-LD structured data from a webpage. Returns schema.org entities like Article, Product, Organization, FAQ, BreadcrumbList, etc.
Inputs: url (required), mode, render, wait_until, +1 more.
tooltrace_seo_auditAInspect
Run an SEO audit on a webpage. Returns a score (0-100), weighted checks for metadata, headings, images, canonical signals, robots directives, social tags, schema, and content length, with evidence and recommendations.
Inputs: url (required), render, wait_until, wait_for_selector.
tooltrace_sitemapAInspect
Inspect a website's sitemap. Discovers sitemap URLs, parses sitemap XML, and returns listed page URLs with last-modified dates and change frequencies.
Inputs: url (required), render.
tooltrace_tech_stackBInspect
Detect the technology stack of a website: CMS, frameworks, JavaScript libraries, analytics, CDN, hosting, fonts, security tools, and more. Returns categorized detections with confidence levels.
Inputs: url (required), render, wait_until, wait_for_selector.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct website analysis concern (sitemap, content, metadata, links, schema, SEO audit, tech stack), and descriptions clarify specialized use cases. The main ambiguity is that tooltrace_extract includes metadata, links, and schema, potentially overlapping with the dedicated extraction tools, but explicit 'lightweight' and 'specific' intent reduces confusion.
All tools follow a consistent 'tooltrace_<feature>' pattern using snake_case, making the naming predictable and uniform. Although one tool uses a verb (extract) while others use nouns, the pattern is consistent and no mixing of conventions exists.
Seven tools is well within the ideal 3-15 range for a website analysis server. Each tool serves a distinct, useful function without redundancy or unnecessary bloat.
The server covers the core website analysis workflow: discovery (sitemap), content extraction, metadata, links, structured data, SEO auditing, and tech stack detection. Minor gaps like a dedicated robots.txt checker or performance metrics are absent, but agents can accomplish primary tasks without significant workarounds.
Maintenance
Related MCP Connectors
Web data for agents. Extract web pages, crawl websites, discover URLs, and search the web.
Web scraping, search, crawling, structured extraction and research for AI agents.
Company profiles, site audits and page-to-JSON extraction for AI agents.
Web data for agents: YouTube transcripts, screenshots, Google News, WHOIS, jobs, tech stack, more.
Related MCP Servers
AlicenseAqualityBmaintenanceEnables AI assistants to scrape pages, batch-process URLs, and crawl entire websites with AI-powered extraction.28133 npmMIT- FlicenseNot gradedqualityCmaintenanceEnables AI agents to search the web, read and extract content from webpages, fetch JSON from REST APIs, and collect links while bypassing anti-bot protections.-
- FlicenseNot gradedqualityAmaintenanceEnables language models and AI assistants to scrape, extract, search, crawl, generate schemas, and monitor web data through an API-backed toolset.-
- FlicenseNot gradedqualityAmaintenanceEnables language models to perform AI-powered web scraping, structured data extraction, web search, crawling, schema generation, and monitor management through integrated API tools.-