Skip to content

MirageScouting Developers

Build on MirageScouting

Read the open roles on the MirageScouting job board from code, from an AI agent or from a terminal, and connect AI assistants to companies and candidates who opted in. Every surface is read-only and machine-readable.

Surfaces

Four ways in, one job board

The REST API, the public MCP server and the CLI read the same public job board as the /jobs pages. The full MCP server adds company profiles and opted-in candidates behind sign-in.

  • REST API

    Search open roles and read one role with its full description. No key; 120 requests per minute per IP, with RateLimit headers on every response.

    GET https://www.miragescouting.de/api/v1/jobs

  • Public MCP server

    For AI agents without sign-in: the tools search_jobs and get_job, and the site guides (llms.txt, the OpenAPI description, the API catalog) as resources.

    https://www.miragescouting.de/api/mcp

  • Full MCP server

    Companies, open roles and the candidates who chose to be found, from Claude, ChatGPT or Gemini. Sign-in uses OAuth in your browser; every tool is read-only.

  • miragescouting CLI

    Search open roles from a terminal or a script. Add --json for machine-readable output.

    npx miragescouting jobs "product manager"

Machine-readable

Files agents read first

Start from any of these; each links to the others.