adhistory-mcp

An MCP server that gives AI agents (Claude Desktop, Claude Code, Cursor and any other MCP client) fifteen data tools for jobs people actually ask an assistant to do:

• Competitor Google ads: the Search, YouTube, Shopping and Display ads any company runs, from the Google Ads Transparency Center.
• App reviews: App Store and Google Play reviews, filterable to 1-2 star complaints.
• Job postings: open jobs from Workday career sites, Greenhouse, Lever and Ashby boards, and remote jobs from six remote job boards (Remotive, Remote OK, We Work Remotely, Jobicy, Himalayas, Arbeitnow) with pay parsed.
• Telegram channels: posts from public channels with views, reactions and links, and which posts beat the channel's usual views.
• Google Sheets: read a tab of a public Google Sheet as rows keyed by column name.
• PDF tables: tables from PDF links as rows, plus CSV and Excel.
• Bank statements: statement PDFs as transactions, balances and a balance check.
• Invoices: invoice PDFs as number, dates, vendor, totals, tax and line items.
• Payslips: payslip PDFs as gross, tax, deductions, net pay and earnings lines.
• Table images: tables in screenshots or photos as rows, via OCR.
• Email list cleaning: syntax, MX, disposable, role-account and typo checks.
• Website screenshots: a full page screenshot (or first screen) of any public URL, as an image link.
• Broken links: crawl a site and list broken links, images and scripts.

Each tool runs one public Apify Actor on your own Apify account and returns the results as JSON, trimmed so they fit in an agent's context. You need a free Apify API token. You pay only the Actor's per-result price, which at the default limits is a few cents or less per call, and Apify's free monthly platform credits cover your first runs, so you can try every tool without paying anything.

Quick start

1. Create a free Apify account at https://console.apify.com/sign-up.
2. Copy your API token: console.apify.com → Settings → API & Integrations.
3. Add the server to your MCP client (examples below). It runs locally over stdio with uvx, so you need uv installed (curl -LsSf https://astral.sh/uv/install.sh | sh on macOS/Linux, or brew install uv).

Claude Desktop

Edit claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "adhistory": {
      "command": "uvx",
      "args": ["adhistory-mcp"],
      "env": { "APIFY_TOKEN": "apify_api_your_token_here" }
    }
  }
}

Restart Claude Desktop. The tools appear under the tools icon.

Claude Code

claude mcp add adhistory --env APIFY_TOKEN=apify_api_your_token_here -- uvx adhistory-mcp

Cursor

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "adhistory": {
      "command": "uvx",
      "args": ["adhistory-mcp"],
      "env": { "APIFY_TOKEN": "apify_api_your_token_here" }
    }
  }
}

Other clients

Any MCP client that can launch a stdio server works: command uvx, argument adhistory-mcp, environment variable APIFY_TOKEN. Without uv: pip install adhistory-mcp, then run adhistory-mcp.

Tools

... View full README on GitHub