Djinni MCP

Find public Djinni jobs from a local MCP client, keep your search preferences, and save recommendations without repeatedly entering your profile.

Preview release: 0.3.0rc1 is intended for independent Linux testing. Local package checks passed on macOS with Python 3.11 and 3.14. Independent Linux acceptance and Windows acceptance remain separate from automated checks.

Connect

Install uv once. In an MCP client that supports local stdio servers and mcpServers configuration, add:

{
  "mcpServers": {
    "djinni": {
      "command": "uvx",
      "args": ["djinni-mcp@0.3.0rc1"]
    }
  }
}

The client starts the server; uvx obtains the package, compatible Python if needed under uv's normal download policy, and dependencies. No Git clone, manual virtual environment, Djinni account, API key or separate development package is required. If the client cannot find uvx, use its full executable path. Other clients may use a different configuration format.

Restart the MCP connection and ask:

Use Djinni MCP to find five jobs for me. Read the workflow and my saved profile first. Ask for missing preferences, offer an optional CV and achievements, and ask whether I want application drafts. Save the recommendations. Do not send applications.

What it does

• Searches public Djinni vacancies and reads their current public details.
• Reuses your explicitly saved profile, labels previous recommendations and supports manual exclusions.
• Saves recommendation history in SQLite and readable Markdown reports.
• Supplies guidance for company context, candidate fit and optional drafts to your AI client.

Your AI client performs matching and writes summaries. Company context comes from vacancy text; external company research requires your request. Public-source coverage is limited/unknown, and a remote vacancy may still restrict eligible countries.

Your data

The server creates private state only when you ask it to save or update data. Default data folders are:

The folder contains state.sqlite3 and reports/. It is independent of the source checkout and uv cache. Set DJINNI_MCP_DATA_DIR to a private absolute directory if you want a different location; keep it stable across clients and updates. To reuse an older source installation's profile, point this variable at its existing data directory. Existing data is never searched for or migrated automatically.

There is no Djinni account access, document scanning, automatic application sending or background job. The server does not read CV files itself. Saved candidate facts are returned to your chosen AI client and may be processed by its provider. SQLite is ordinary local storage, not an encrypted vault. uvx isolates dependencies, not operating-system permissions.

Inspect and troubleshoot

Expected tools: get_workflow, get_profile, update_profile, search_jobs, get_job, get_history, save_search, set_job_excluded.

uvx djinni-mcp@0.3.0rc1 --version prints the release version. Starting without arguments waits for an MCP client; it is not an interactive terminal interface.

The public source repository contains the implementation and tests. Published wheels contain readable Python source; download and inspect the actual release as well as its source tag. Open source and provenance records help review but do not guarantee safety. The code is MIT licensed; dependency licenses and Djinni content are separate.

See connection and troubleshooting. Report problems using synthetic examples, without CVs, populated data folders, credentials or personal paths.