Tooltrace

io.tooltracePublished by tooltrace.ioOfficial publisherv0.1.3Updated Nov 2, 2026

Web tools for AI agents: scrape pages to Markdown, audit SEO, detect tech stacks, check sitemaps

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingData & Analytics

Overview

AI-generated overview

ToolTrace fetches web pages and gives an assistant clean Markdown, metadata, links, JSON-LD, SEO audits, tech-stack detections and sitemap data.

What you can do
  • Extract a page's main content as Markdown, plain text, metadata, links, JSON-LD and sections
  • Read page metadata such as title, description, canonical URL, Open Graph and Twitter card fields
  • List all internal and external links with anchor text and normalized URLs
  • Pull JSON-LD structured data such as Article, Product, Organization or FAQ entities
  • Run a scored on-page SEO audit with checks, evidence and recommendations
  • Detect a site's CMS, frameworks, analytics, CDN, hosting and other technologies, and inspect XML sitemaps
When to use it
Useful when an assistant needs to read or analyze public web pages: scraping content for RAG ingestion, checking competitor tech stacks, auditing landing pages for SEO, or mapping a site through its sitemap.
Requirements
A ToolTrace API key, supplied as the TOOLTRACE_API_KEY environment variable for the local npm package or as an Authorization bearer header for the hosted endpoint. Either the remote endpoint or Node.js to run the npm package over stdio. Network access to the ToolTrace API.
Before you install
The API key is a secret and is sent to ToolTrace; the local stdio mode keeps it on your machine, while the hosted mode sends it in the Authorization header. Calls consume credits from a metered plan, with browser rendering costing more than static fetches. Pages you submit are fetched by ToolTrace's servers, so avoid sending private or internal URLs.

Installation

In SourceWeft

  1. Open Tooltrace in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.tooltrace%2Fmcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "tooltrace": {
      "type": "http",
      "url": "https://mcp.tooltrace.io/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

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

ToolDescription
tooltrace_extractExtract clean Markdown, text, metadata, links, JSON-LD, and sections from any webpage
tooltrace_metadataGet page title, description, canonical URL, Open Graph, and Twitter card fields
tooltrace_linksExtract all internal and external links with anchor text
tooltrace_schemaExtract JSON-LD structured data (Article, Product, FAQ, etc.)
tooltrace_seo_auditRun an SEO audit with scored checks and recommendations
tooltrace_tech_stackDetect CMS, frameworks, analytics, CDN, hosting, and more
tooltrace_sitemapInspect 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
bash
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

bash
npm install -g @tooltrace/mcp-server

3. Configure your MCP client

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

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

Claude Code:

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

Cursor (.cursor/mcp.json):

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

VS Code (.vscode/mcp.json):

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

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

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

Windsurf (mcp_config.json):

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)

bash
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

bash
git clone https://github.com/ToolTrace-io/mcp-server.gitcd mcp-servernpm installnpm run buildTOOLTRACE_API_KEY=your-key node dist/index.js

License

MIT

Source: README.md at commit 0692e7e

Tools

7

tooltrace_extract

Extract webpage content

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.

Parametersurlrequiredmoderenderincludewait_untilwait_for_selector

tooltrace_metadata

Read page metadata

Extract page metadata: title, description, canonical URL, author, publication date, favicon, Open Graph, and Twitter card fields. Lightweight alternative to full extraction.

Parametersurlrequiredrenderwait_untilwait_for_selector

tooltrace_schema

Extract JSON-LD structured data

Extract JSON-LD structured data from a webpage. Returns schema.org entities like Article, Product, Organization, FAQ, BreadcrumbList, etc.

Parametersurlrequiredmoderenderwait_untilwait_for_selector

tooltrace_seo_audit

Audit on-page SEO

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.

Parametersurlrequiredrenderwait_untilwait_for_selector

tooltrace_tech_stack

Detect the tech stack behind a site

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.

Parametersurlrequiredrenderwait_untilwait_for_selector

tooltrace_sitemap

Check an XML sitemap

Inspect a website's sitemap. Discovers sitemap URLs, parses sitemap XML, and returns listed page URLs with last-modified dates and change frequencies.

Parametersurlrequiredrender

Version history

1
  1. v0.1.3LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts