Enables AI agents to scrape web pages to Markdown, perform SEO audits, detect technology stacks, and inspect XML sitemaps.
Also known as ToolTrace-io/mcp-server, @tooltrace/mcp-server
- Stars
- 0
- Tools
- 7
- Downloads, 30 days
- —
- Latest version
- 0.1.3
- Last commit
- Sep 8, 2026
- License
- MIT
What is ToolTrace MCP?
ToolTrace enables AI agents to scrape web pages to Markdown, perform SEO audits, detect technology stacks, and inspect XML sitemaps. It exposes 7 tools, such as tooltrace_extract, tooltrace_metadata, tooltrace_links.
Summary generated from the project's README
About ToolTrace MCP server
ToolTrace MCP Server provides a web intelligence toolkit designed for AI agents to interact with live websites. It connects various MCP clients like Claude Desktop, Cursor, VS Code, and Windsurf to the ToolTrace API. Developers can use it to transform web pages into clean Markdown, inspect XML sitemaps, or analyze a site's underlying technology stack.
Users can connect via a hosted HTTP transport or a local stdio process. The local installation requires an API key from ToolTrace, which offers a free tier providing 1,000 credits per month. The server includes specific tools such as tooltrace_seo_audit for scored recommendations, tooltrace_tech_stack for identifying CMS and frameworks, and tooltrace_schema for extracting JSON-LD structured data. It also supports different rendering modes, allowing users to choose between fast static fetches or full browser rendering for JavaScript-heavy applications.
What you can do with it
- 1Convert web content to MarkdownAsk an AI agent to pull the primary text from a blog post and format it as Markdown.
- 2Analyze competitor technology stacksRequest an identification of the frameworks, hosting, and analytics used by a specific website.
- 3Perform SEO evaluationsInstruct an agent to run a formal audit on a landing page to receive scores and suggestions.
- 4Extract structured dataUse the agent to retrieve JSON-LD schema information from a product page.
Written from the project's README. Every use case is checked against a quote from it.
How to install ToolTrace MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall ToolTrace MCP in Claude Code
$ claude mcp add --env 'TOOLTRACE_API_KEY=<YOUR_TOOLTRACE_API_KEY>' mcp-server -- npx -y @tooltrace/mcp-serverInstall ToolTrace MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@tooltrace/mcp-server"
],
"env": {
"TOOLTRACE_API_KEY": "<YOUR_TOOLTRACE_API_KEY>"
}
}
}
}Install ToolTrace MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tooltrace/mcp-server"
],
"env": {
"TOOLTRACE_API_KEY": "<YOUR_TOOLTRACE_API_KEY>"
}
}
}
}Install ToolTrace MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@tooltrace/mcp-server"],"env":{"TOOLTRACE_API_KEY":"<YOUR_TOOLTRACE_API_KEY>"}}'Install ToolTrace MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@tooltrace/mcp-server"
],
"env": {
"TOOLTRACE_API_KEY": "<YOUR_TOOLTRACE_API_KEY>"
}
}
}
}Install ToolTrace MCP in Codex
$ codex mcp add mcp-server --env 'TOOLTRACE_API_KEY=<YOUR_TOOLTRACE_API_KEY>' -- npx -y @tooltrace/mcp-serverInstall ToolTrace MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@tooltrace/mcp-server"] [mcp_servers.mcp-server.env] TOOLTRACE_API_KEY = "<YOUR_TOOLTRACE_API_KEY>"
Install ToolTrace MCP in Gemini CLI
$ gemini mcp add -s user -e 'TOOLTRACE_API_KEY=<YOUR_TOOLTRACE_API_KEY>' mcp-server npx -- -y @tooltrace/mcp-serverInstall ToolTrace MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@tooltrace/mcp-server"
],
"env": {
"TOOLTRACE_API_KEY": "<YOUR_TOOLTRACE_API_KEY>"
}
}
}
}ToolTrace MCP tools 7
Detected from the READMEtooltrace_extracttooltrace_metadatatooltrace_linkstooltrace_schematooltrace_seo_audittooltrace_tech_stacktooltrace_sitemap
Configuration
TOOLTRACE_API_KEYRequiredSecretToolTrace API key. Get a free one at https://tooltrace.io/signup
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachabletooltrace-io/mcp-server is public and reachablegithub.com/tooltrace-io/mcp-server ↗Pass
- Package names this repository as its source@tooltrace/mcp-server names tooltrace-io/mcp-server as sourcenpmjs.com/package/@tooltrace/mcp-server ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-08github.com/tooltrace-io/mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @tooltrace/mcp-serverPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 923 msPass
README
View on GitHubToolTrace 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 |
Two ways to connect
Hosted, for clients that take a connector URL. Nothing to install or update:
https://mcp.tooltrace.io/mcp
claude 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-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
ToolTrace MCP questions
How do I add ToolTrace MCP to Claude Code?
Run claude mcp add --env 'TOOLTRACE_API_KEY=<YOUR_TOOLTRACE_API_KEY>' mcp-server -- npx -y @tooltrace/mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add ToolTrace MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does ToolTrace MCP provide?
It exposes 7 tools, including tooltrace_extract, tooltrace_metadata, tooltrace_links, tooltrace_schema, tooltrace_seo_audit.