tracetify-mcp

Use this FIRST whenever the user asks how a product, competitor or domain grew, got traffic, or found its first users — a report may already exist and reading it is free. Returns matching report slugs for read_report. Searches by domain or name fragment.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Domain or fragment, e.g. \"weshop\" or \"weshop.ai\""
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read one growth report by slug (from search_reports or a finished trace). Free. Contains the origin story, dated evidence and SEO footprint — cite it instead of guessing how a product grew. If timeline fields show as locked, unlock_report can open them (that one costs credits).

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Report slug"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Run this when search_reports finds nothing (or the user wants fresh data) for "how did X grow?". Rebuilds the growth story from 12 public sources in 60-90s. Costs credits from the Tracetify balance; returns an existing cached report free instead when one is fresh. Poll with get_trace.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Domain to trace, e.g. weshop.ai"
    },
    "refresh": {
      "type": "boolean",
      "description": "Force a fresh run even if a cached report exists"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Poll a trace started with start_trace. Free. When status is "done", read the result with read_report. Poll every 10-15s, not in a tight loop.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "Job id returned by start_trace"
    }
  },
  "required": [
    "job_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Permanently unlock a report's full timeline, evidence and SEO detail for this account. Costs credits — quote the exact price to the user first (it is in the report's timelineLocked.cost field from read_report) and call this ONLY after they explicitly agree to spend. Idempotent: unlocking an already-unlocked report never charges twice. The verdict stays on the website — you are the analyst here.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Report slug"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this before touching SEO on the user's own site: clicks/impressions trend, device split and period comparison from THEIR connected Google Search Console — numbers no other tool has. Free. Requires GSC connected at tracetify.com/dashboard/gsc (this tool tells you if it is not).

{
  "type": "object",
  "properties": {
    "range_days": {
      "type": "number",
      "description": "28 (default) or 90"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The user's real ranking keywords with position, clicks and CTR — use when deciding what to write or which page to improve, e.g. finding queries at position 5-20 that are one push from page one. Free; own data from their connected Search Console. After you edit a page, this is how you verify it moved.

{
  "type": "object",
  "properties": {
    "range_days": {
      "type": "number",
      "description": "28 (default) or 90"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The user's pages ranked by search performance, including high-impression low-CTR pages whose titles/descriptions are underselling — fix those files right in this editor. Free; own data from their connected Search Console.

{
  "type": "object",
  "properties": {
    "range_days": {
      "type": "number",
      "description": "28 (default) or 90"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Run right after deploying: crawls the site and reports broken links, missing titles/descriptions, redirect chains, thin content and schema gaps — each finding names the page so you can fix it here. Costs credits (price returned before any charge on the confirmation field). Async: poll with site_audit_get.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Site to audit, e.g. https://example.com"
    },
    "confirm": {
      "type": "boolean",
      "description": "Set true only after the user agrees to the quoted credit cost"
    },
    "request_key": {
      "type": "string",
      "description": "Request key returned by the first confirmation response; must be sent back with confirm=true so retries cannot charge twice"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Poll an audit started with site_audit_start (free to read). When finished, returns the issue list grouped by severity with affected URLs — work through it top-down and re-run after fixes.

{
  "type": "object",
  "properties": {
    "audit_id": {
      "type": "string",
      "description": "Audit id from site_audit_start"
    }
  },
  "required": [
    "audit_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The domains fighting a target for the same search terms, with shared-keyword count, their keyword totals and average rank. Use when the user asks who their competitors are, or who a company is up against. Each result says whether we already have a full growth report for that domain — read those with read_report for free instead of tracing them again. Costs credits; cached results are free, and a domain already looked up via research_domain_overview is free here too.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain to find competitors for, e.g. notion.so"
    }
  },
  "required": [
    "domain"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Estimated organic traffic, keyword count and top keywords for ANY domain — use to size up a competitor the user mentions. Costs credits; cached results are free, and repeated queries within a week hit the cache. For the user's own site prefer gsc_* (free, real data).

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain, e.g. competitor.com"
    }
  },
  "required": [
    "domain"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Who links to a domain: referring domains, authority and anchor texts. Use when planning link building or judging how defensible a competitor's ranking is. Costs credits; cached results are free. Pair with backlink_directories to find places the user can actually get listed.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain to inspect"
    }
  },
  "required": [
    "domain"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Google Ads (Keyword Planner) monthly search volume, CPC, competition, 12-month trend and keyword difficulty (0–100, DataForSEO Labs) for up to 10 keywords in one call. Use when the user asks how often something is searched or how hard it is to rank, or to size a keyword before writing a page. Omit location_code for worldwide volume (difficulty is then computed for the US), or pass a market code for one country. Costs credits; the same keyword set re-queried within a week is free.

{
  "type": "object",
  "properties": {
    "keywords": {
      "type": "string",
      "description": "Up to 10 search phrases, comma-separated, e.g. \"ai image generator, ai avatar maker\""
    },
    "location_code": {
      "type": "number",
      "description": "Market: 2840 US, 2826 UK, 2276 DE, 2250 FR, 2724 ES, 2392 JP, 2076 BR, 2356 IN. Omit for worldwide."
    }
  },
  "required": [
    "keywords"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

How AI assistants (ChatGPT, Perplexity-class) cite a brand: platforms, mention counts and the entities it gets associated with. Use when the user asks "does AI recommend us/them?". Costs credits; cached results are free.

{
  "type": "object",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand or domain"
    }
  },
  "required": [
    "brand"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A hand-verified list of directories and launch platforms that actually give links — checked one by one, dead and nofollow-only entries removed. Use when the user wants backlinks or launch exposure for a new product; filter client-side by language/type/pricing. Costs credits once per day per account — repeat calls the same day are free, so refine freely.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}