tinyrex-mcp

Serveur MCP Python stdio qui permet à tout client MCP de répertorier et d’exécuter 27 petits scrapers TinyRex sur Apify (offres d’emploi à distance provenant de 6 sites, catalogues de boutiques Shopify et détection d’applications, transcription audio et vidéo, registres d’entreprises, appels d’offres) avec votre propre APIFY_TOKEN et renvoie les lignes du jeu de données. Sous licence MIT. Je l’ai créé et je le maintiens.

GitHub
2

Documentation

tinyrex-mcp

Listed on mcpservers.org

Featured on LaunchIgniter

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

ToolWhat it does
list_actorsLists all 27 public TinyRex actors (name, title, description, Store URL, example input).
run_actorRuns 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:

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.