Skip to content
Back to search

clearstack-data-mcp

MCP server: open roles on 25,787 company career sites, Google Ads Transparency Center, public Telegram channels and EU VAT/registry checks, via Apify.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wordhalm--clearstack-data-mcp/badge.svg)](/listings/wordhalm--clearstack-data-mcp)

HTML

<a href="/listings/wordhalm--clearstack-data-mcp"><img src="/api/listings/wordhalm--clearstack-data-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

You need Node.js 20 or later and an Apify API token from [console.apify.com/settings/integrations](https://console.apify.com/settings/integrations).

Claude Code

claude mcp add clearstack-data -e APIFY_TOKEN=your_token -- npx -y github:Wordhalm/clearstack-data-mcp

Claude Desktop

Settings → Developer → Edit Config, then add:

{
  "mcpServers": {
    "clearstack-data": {
      "command": "npx",
      "args": ["-y", "github:Wordhalm/clearstack-data-mcp"],
      "env": { "APIFY_TOKEN": "your_token" }
    }
  }
}

Cursor and Windsurf

Same block as Claude Desktop, in `.cursor/mcp.json` (Cursor) or `~/.codeium/windsurf/mcp_config.json` (Windsurf).

VS Code

`.vscode/mcp.json` (VS Code asks for the token once and stores it securely):

{
  "inputs": [
    { "type": "promptString", "id": "apify-token", "description": "Apify API token", "password": true }
  ],
  "servers": {
    "clearstack-data": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:Wordhalm/clearstack-data-mcp"],
      "env": { "APIFY_TOKEN": "${input:apify-token}" }
    }
  }
}

The first start takes up to a minute while npx downloads and builds the server (41 s measured on a cold cache).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 183 lines
  1. # ClearStack Data MCP server
  2. [![CI](https://github.com/Wordhalm/clearstack-data-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Wordhalm/clearstack-data-mcp/actions/workflows/ci.yml)
  3. [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  4. Four research tools for Claude, Cursor, VS Code and any other MCP client:
  5. | Tool | Answers questions like | Cost per call |
  6. | --- | --- | --- |
  7. | `search_ats_jobs` | "Which of Datadog, Snowflake and Databricks are hiring data engineers in Europe?" | $0.002 + $0.0015 per job |
  8. | `search_google_ads` | "What Google Ads has notion.so run in the UK over the last 30 days?" | $0.002 + $0.0012 per ad |
  9. | `get_telegram_channel_posts` | "Summarise this week's posts from t.me/durov." | $0.002 + $0.0015 per post |
  10. | `verify_eu_company` | "Is FR22424761419 a valid VAT number, and which company is it?" | $0.004 per company |
  11. A fifth tool, `get_run_results`, collects the rest of a search that took longer than 45 seconds.
  12. Each tool runs a [ClearStack Data](https://apify.com/clearstack-data) Actor on [Apify](https://apify.com) with **your own Apify API token**. Costs are billed by Apify to your account; Apify's free plan is enough to try every tool. Every call sends Apify a spending cap, so a call never costs more than the price above for the number of results you asked for.
  13. ## Install
  14. You need Node.js 20 or later and an Apify API token from [console.apify.com/settings/integrations](https://console.apify.com/settings/integrations).
  15. ### Claude Code
  16. ```
  17. claude mcp add clearstack-data -e APIFY_TOKEN=your_token -- npx -y github:Wordhalm/clearstack-data-mcp
  18. ```
  19. ### Claude Desktop
  20. Settings → Developer → Edit Config, then add:
  21. ```json
  22. {
  23. "mcpServers": {
  24. "clearstack-data": {
  25. "command": "npx",
  26. "args": ["-y", "github:Wordhalm/clearstack-data-mcp"],
  27. "env": { "APIFY_TOKEN": "your_token" }
  28. }
  29. }
  30. }
  31. ```
  32. ### Cursor and Windsurf
  33. Same block as Claude Desktop, in `.cursor/mcp.json` (Cursor) or `~/.codeium/windsurf/mcp_config.json` (Windsurf).
  34. ### VS Code
  35. `.vscode/mcp.json` (VS Code asks for the token once and stores it securely):
  36. ```json
  37. {
  38. "inputs": [
  39. { "type": "promptString", "id": "apify-token", "description": "Apify API token", "password": true }
  40. ],
  41. "servers": {
  42. "clearstack-data": {
  43. "type": "stdio",
  44. "command": "npx",
  45. "args": ["-y", "github:Wordhalm/clearstack-data-mcp"],
  46. "env": { "APIFY_TOKEN": "${input:apify-token}" }
  47. }
  48. }
  49. }
  50. ```
  51. The first start takes up to a minute while npx downloads and builds the server (41 s measured on a cold cache).
  52. ## Tools
  53. ### `search_ats_jobs`
  54. Open roles read directly from company career sites on Greenhouse, Lever, Ashby and SmartRecruiters (25,787 employers indexed; look one up at [ATS Job Board Finder](https://wordhalm.github.io/ats-job-board-finder/)).
  55. | Parameter | Default | |
  56. | --- | --- | --- |
  57. | `companies` | `[]` | Names (`"Stripe"`), `ats:slug` pairs (`"ashby:openai"`) or job board URLs. Empty: 35 well-known tech and AI employers. |
  58. | `keywords` | `[]` | Match any of them in title or department. |
  59. | `location` | `""` | Substring of the location: `"London"`, `"Remote"`, `"Germany"`. |
  60. | `remoteOnly` | `false` | |
  61. | `maxJobs` | `50` | 1–500. |
  62. ```json
  63. {"company":"Airbnb","ats":"greenhouse","title":"Account Executive (Hotels)","location":"Barcelona, Spain","isRemote":false,"publishedAt":"2026-11-10","applyUrl":"https://careers.airbnb.com/positions/8365363?gh_jid=8365363"}
  64. ```
  65. ### `search_google_ads`
  66. Ads from the public [Google Ads Transparency Center](https://adstransparency.google.com).
  67. | Parameter | Default | |
  68. | --- | --- | --- |
  69. | `targets` | required | 1–10 domains (`"stripe.com"`), advertiser IDs or Transparency Center URLs. |
  70. | `region` | `"ALL"` | ISO-2 country code. |
  71. | `format` | `"ALL"` | `TEXT`, `IMAGE` or `VIDEO`. |
  72. | `dateRangeDays` | `30` | 0 = all history. |
  73. | `maxAdsPerTarget` | `20` | 1–100. |
  74. ```json
  75. {"target":"stripe.com","advertiserName":"Stripe, Inc.","advertiserId":"AR16951989901585285121","creativeId":"CR13805501473330561025","format":"TEXT","firstShownDate":"2026-07-31","lastShownDate":"2026-11-22","variationsCount":114,"adUrl":"https://adstransparency.google.com/advertiser/AR16951989901585285121/creative/CR13805501473330561025"}
  76. ```
  77. ### `get_telegram_channel_posts`
  78. Posts from public channels, read from Telegram's public web preview. No Telegram account or phone number.
  79. | Parameter | Default | |
  80. | --- | --- | --- |
  81. | `channels` | required | 1–10 usernames or URLs: `"durov"`, `"@telegram"`, `"https://t.me/bloomberg"`. |
  82. | `maxPostsPerChannel` | `30` | 1–200, newest first. |
  83. | `sinceDate` | `""` | `YYYY-MM-DD`; older posts are skipped. |
  84. | `keywords` | `[]` | Only posts containing any of them. |
  85. ```json
  86. {"channel":"durov","channelTitle":"Pavel Durov","channelSubscribersNum":9910000,"messageId":568,"postUrl":"https://t.me/durov/568","publishedAt":"2026-11-21T22:48:52+00:00","text":"You won't look professional in 2027 if your QR is unpimped.","viewsNum":242000,"hasPhoto":false,"hasVideo":true,"hasDocument":false,"reactionsTotal":8870,"paidStars":1120}
  87. ```
  88. `paidStars` is the number of Telegram Stars paid as reactions; it is not added to `reactionsTotal`.
  89. ### `verify_eu_company`
  90. VAT check against the European Commission's VIES service, plus the official registry record from France (SIRENE), Switzerland (Zefix), Norway (Brreg), Finland (PRH) and GLEIF.
  91. | Parameter | Default | |
  92. | --- | --- | --- |
  93. | `queries` | required | 1–200 VAT numbers, French SIREN/SIRET, Swiss UID (`CHE-105.909.036`), Norwegian org numbers (`NO:923609016`). |
  94. | `defaultCountry` | `""` | ISO-2 country for plain company names. |
  95. ```json
  96. {"query":"FR22424761419","found":true,"kybStatus":"VERIFIED_ACTIVE","country":"FR","legalName":"OVH (OVHCLOUD)","registrationNumber":"424761419","vatNumber":"FR22424761419","vatValid":true,"leiCode":"9695007586GCAKPYJ703","status":"ACTIVE","incorporationDate":"1999-10-15","address":{"full":"2 RUE KELLERMANN 59100 ROUBAIX"}}
  97. ```
  98. `vatValid` is `null` when VIES could not give a verdict (a member state's service is often busy). That means "check again later", not "invalid".
  99. ### `get_run_results`
  100. MCP clients usually stop waiting after 60 seconds, so each tool waits at most 45 seconds. A larger search returns the results found so far with `finished: false` and a `runId`; the model then calls `get_run_results` with that `runId`. No extra charge.
  101. ## Structured output
  102. Every tool returns `structuredContent` matching its declared `outputSchema`:
  103. ```json
  104. { "actor": "clearstack-data/career-site-jobs-search", "runId": "…", "status": "SUCCEEDED", "finished": true, "itemCount": 3, "items": [] }
  105. ```
  106. Empty fields are dropped from items to save tokens.
  107. ## Security and privacy
  108. - The token is read from the `APIFY_TOKEN` environment variable and sent only to `api.apify.com`, in an `Authorization` header, never in a URL.
  109. - No telemetry, nothing written to disk. The only log line goes to stderr at startup.
  110. - All data comes from public sources: company career sites, Google's Ads Transparency Center, Telegram's public web preview, VIES and official company registries.
  111. ## Troubleshooting
  112. | Message | Fix |
  113. | --- | --- |
  114. | `APIFY_TOKEN is not set` | Add the token to the `env` block of your client config and restart the client. |
  115. | `HTTP 401` | The token is wrong or was revoked. |
  116. | `usage or spending limit` | Raise the limit or upgrade at [console.apify.com/billing](https://console.apify.com/billing). |
  117. | `may not be public yet` | The Actor is not available to your account; open an issue. |
  118. | `finished: false` | Normal for large searches: ask the model to call `get_run_results`. |
  119. ## Compared with Apify's own MCP server
  120. [Apify's MCP server](https://github.com/apify/apify-mcp-server) can load these Actors too (`https://mcp.apify.com?tools=clearstack-data/career-site-jobs-search`) and exposes their full input schemas. This server wraps them with fewer parameters, trims the output, caps spending on every call and handles long runs. Use whichever fits your client.
  121. ## Development
  122. ```
  123. npm install # dev tools need Node 22+
  124. npm test # unit tests on real Actor output
  125. node scripts/smoke.mjs # stdio check, no token needed
  126. npm run e2e # one real call per tool (APIFY_TOKEN set), under $0.05
  127. npm run pack:mcpb # build the Claude Desktop bundle
  128. ```
  129. ## License
  130. MIT. Not affiliated with Greenhouse, Lever, Ashby, SmartRecruiters, Google, Telegram or the European Commission.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.