tinyrex-mcp

tinyrex-mcp

Run TinyRex Apify Store actors from Claude Desktop, Cursor, and other MCP hosts, using your own APIFY_TOKEN.

This is a thin stdio Model Context Protocol server: it lists the public TinyRex actors and starts a run, then returns dataset items (capped for MCP hosts).

Actors are pay-per-event (PPE) on Apify. Failed or empty runs are often free under TinyRex pricing: check each actor's Store page. You pay Apify with your own account; this MCP does not bill separately.

Install

Python 3.11+:

pip install git+https://github.com/emirmrkaljevic/tinyrex-mcp.git
# or clone and:
# pip install -e .

Requires an Apify API token in the environment as APIFY_TOKEN.

Claude Desktop / Cursor (mcpServers)

{
  "mcpServers": {
    "tinyrex": {
      "command": "tinyrex-mcp",
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

If the script is not on PATH, use the module form:

{
  "mcpServers": {
    "tinyrex": {
      "command": "python",
      "args": ["-m", "tinyrex_mcp"],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

Tools

Tool	What it does
list_actors	Lists all 27 public TinyRex actors (name, title, description, Store URL, example input).
run_actor	Runs tinyrex/<name> with an input object, waits for the run, returns dataset items (default max 50) plus itemCount, runId, and status.

Example: LEI lookup

1. list_actors → find gleif-lei-lookup
2. run_actor with:

{
  "actor": "gleif-lei-lookup",
  "input": { "companyNames": ["Siemens AG"], "maxResultsPerName": 1 },
  "max_items": 5
}

More prompt-to-tool-call examples are in docs/examples.md.

Public actors wrapped

list_actors returns all 27 public TinyRex actors. Store pages:

• tech-stack-detector
• ats-jobs-scraper
• shopify-products-scraper
• workday-jobs-scraper
• woocommerce-products-scraper
• ted-tenders-scraper
• eu-grants-scraper
• remote-jobs-scraper
• rss-feed-scraper
• sitemap-scraper
• contact-details-extractor
• us-uk-tenders-scraper
• tenderned-tenders-scraper
• seo-on-page-audit
• broken-link-checker
• gleif-lei-lookup
• uk-companies-house-lookup
• bulk-website-screenshot
• bulk-email-validator
• pdf-ocr-text-extractor
• npi-registry-lookup
• lighthouse-audit
• sec-edgar-filings-scraper
• france-company-search
• norway-company-search
• finland-company-search
• audio-video-transcriber

Private / ToS-blocked actors are not exposed.

Docker (stdio)

docker build -t tinyrex-mcp .
docker run --rm -i -e APIFY_TOKEN=YOUR_APIFY_TOKEN tinyrex-mcp

Development

python -m venv .venv && source .venv/bin/activate
pip install -e .
APIFY_TOKEN=... tinyrex-mcp   # stdio MCP

Unit tests that do not need an Apify token: python -m unittest discover -s tests.

Smoke-test helpers (list tools + one cheap run, needs APIFY_TOKEN) live in scripts/smoke_test.py.

License

MIT. Brand: TinyRex. Store username: tinyrex.