tinyrex-mcp

Herhangi bir MCP istemcisinin Apify üzerinde 27 küçük TinyRex scraper'ını listeleyip çalıştırmasını sağlayan Python stdio MCP sunucusu (6 iş panosundan uzaktaki işler, Shopify mağaza katalogları ve uygulama tespiti, ses ve video transkripsiyonu, şirket sicilleri, ihaleler); kendi APIFY_TOKEN'ınızı kullanır ve veri kümesi satırlarını döndürür. MIT lisanslıdır. Geliştiren ve bakımını yapan benim.

GitHub
2

Dokümantasyon

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.