Skip to main content
Glama

tinyrex-mcp

Listed on mcpservers.org

Run TinyRex Apify Store actors from any MCP-capable AI agent (Claude Desktop, Cursor, and others) 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.

Related MCP server: veriloop

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
}

Public actors wrapped

Actor

Store

tech-stack-detector

apify.com/tinyrex/tech-stack-detector

ats-jobs-scraper

apify.com/tinyrex/ats-jobs-scraper

shopify-products-scraper

apify.com/tinyrex/shopify-products-scraper

workday-jobs-scraper

apify.com/tinyrex/workday-jobs-scraper

woocommerce-products-scraper

apify.com/tinyrex/woocommerce-products-scraper

ted-tenders-scraper

apify.com/tinyrex/ted-tenders-scraper

eu-grants-scraper

apify.com/tinyrex/eu-grants-scraper

remote-jobs-scraper

apify.com/tinyrex/remote-jobs-scraper

rss-feed-scraper

apify.com/tinyrex/rss-feed-scraper

sitemap-scraper

apify.com/tinyrex/sitemap-scraper

contact-details-extractor

apify.com/tinyrex/contact-details-extractor

us-uk-tenders-scraper

apify.com/tinyrex/us-uk-tenders-scraper

tenderned-tenders-scraper

apify.com/tinyrex/tenderned-tenders-scraper

seo-on-page-audit

apify.com/tinyrex/seo-on-page-audit

broken-link-checker

apify.com/tinyrex/broken-link-checker

gleif-lei-lookup

apify.com/tinyrex/gleif-lei-lookup

uk-companies-house-lookup

apify.com/tinyrex/uk-companies-house-lookup

bulk-website-screenshot

apify.com/tinyrex/bulk-website-screenshot

bulk-email-validator

apify.com/tinyrex/bulk-email-validator

pdf-ocr-text-extractor

apify.com/tinyrex/pdf-ocr-text-extractor

npi-registry-lookup

apify.com/tinyrex/npi-registry-lookup

lighthouse-audit

apify.com/tinyrex/lighthouse-audit

sec-edgar-filings-scraper

apify.com/tinyrex/sec-edgar-filings-scraper

france-company-search

apify.com/tinyrex/france-company-search

norway-company-search

apify.com/tinyrex/norway-company-search

finland-company-search

apify.com/tinyrex/finland-company-search

audio-video-transcriber

apify.com/tinyrex/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

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

License

MIT. Brand: TinyRex. Store username: tinyrex.

Available Tools

2 tools
list_actorsA

List all public TinyRex Apify Store actors this MCP can run.

Returns name, title, short description, Store URL, and an example input for each actor. Private / ToS-blocked actors are not included.

Inputs: no named parameters. Returns: result

run_actorA

Run a TinyRex Apify actor and return dataset items.

Args: actor: Actor name (e.g. "gleif-lei-lookup") or "tinyrex/". input: Actor input object (same fields as on the Apify Store). Use list_actors exampleInput as a starting point. max_items: Max dataset items to return (default 50). Total count is always included. timeout_secs: How long to wait for the run to finish (default 180). memory_mbytes: Optional memory override for the run (Apify default if omitted).

Inputs: actor (required), input, max_items, timeout_secs, +1 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: list_actors for discovery and run_actor for execution. There is no overlap, and the descriptions explain their relationship through the exampleInput field.

    Naming Consistency5/5

    Both names follow a consistent snake_case verb_noun pattern: list_actors and run_actor. The verbs are distinct and the noun is consistent.

    Tool Count3/5

    Only two tools are provided, which is below the typical 3-15 range and may feel thin for a server that might need run management. However, for the narrow scope of discovering and running actors, it could be sufficient.

    Completeness4/5

    The surface covers actor discovery and execution, including example inputs and result retrieval. However, it lacks operations for managing runs (e.g., status, cancellation, or retrieving past runs), which agents might need for long-running or async actors.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      A lightweight stdio-only MCP server that allows AI agents to run multiple tasks (e.g., Python code, HTTP requests, shell commands) in parallel or with dependencies, returning structured results in a single call.
      2
      47 PyPI
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Exposes a verified tool registry (calculator, sandboxed file read, web fetch) over MCP stdio, enabling any MCP-capable client to reuse the same tools from the inspectable ReAct loop.
      3
      MIT