Skip to main content

Remote Jobs API — MCP Server

A Model Context Protocol server that gives any MCP client — Claude Desktop, Cursor, Claude Code, OpenRouter agents, or any MCP-compatible harness — access to live, normalized remote-job data across multiple job boards through the keyless Remote Jobs API.

One endpoint, one schema. No API key. No account.

What it gives your agent

Three tools, all backed by live data:

  • search_jobs_tool — search live remote jobs by skill keywords and/or a minimum-salary floor. Returns a lean per-job shape (title, company, location, salary, category, source, link).
  • market_stats_tool — live feed health: which boards are up and how many jobs are live right now.
  • salary_band_tool — a live salary band (min / median / max) for a skill filter, so your agent can answer "what does a senior backend engineer pay remote?" from real listings.

Install

pip install remote-jobs-api-mcp

Or from this repo:

pip install .

Run

remote-jobs-api-mcp          # stdio transport (what MCP clients launch)
# or
python -m remote_jobs_api.mcp_server

No environment variables or volumes required. The base URL defaults to the public, keyless instance https://remote-jobs-api.tten.no and can be overridden with the RJA_BASE_URL environment variable.

Claude Desktop / Claude Code

Add to ~/.claude/claude_desktop_config.json (or your MCP client config):

{
  "mcpServers": {
    "remote-jobs-api": {
      "command": "remote-jobs-api-mcp",
      "env": { "RJA_BASE_URL": "https://remote-jobs-api.tten.no" }
    }
  }
}

Docker

docker build -t remote-jobs-api-mcp .
docker run -i --rm remote-jobs-api-mcp   # speaks MCP over stdio

Notes

This package is the client only: a thin, stdlib-only HTTP wrapper around the public API. It contains no secrets, credentials, or backend logic. The data source is the free, keyless tier of the Remote Jobs API.

License

MIT

Metadata

Release files for remote-jobs-api-mcp 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for remote-jobs-api-mcp 1.0.0
File Size Uploaded Provenance Actions
remote_jobs_api_mcp-1.0.0.tar.gz 5.1 kB Without provenance Details for remote_jobs_api_mcp-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for remote-jobs-api-mcp 1.0.0
File Interpreter ABI Platform Actions
remote_jobs_api_mcp-1.0.0-py3-none-any.whl Python 3 none any Details for remote_jobs_api_mcp-1.0.0-py3-none-any.whl

Total release size: 11.3 kB

Release files / remote_jobs_api_mcp-1.0.0.tar.gz

Download URL remote_jobs_api_mcp-1.0.0.tar.gz
Size 5.1 kB
Tags Source
SHA-256 checksum
How to use checksums
6440abf03a418918006e5c17119bf3bf4ebc86081d4b7c53c690b9d51a789320
BLAKE2b-256 checksum
How to use checksums
c335b9801501e01e272967e1294f9ab26e3cb723b6385d701e82f54503880f0f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.9

Release files / remote_jobs_api_mcp-1.0.0-py3-none-any.whl

Download URL remote_jobs_api_mcp-1.0.0-py3-none-any.whl
Size 6.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
eb07fc1e73bb6af18eba48048519c3c0c3f8cb0c13b42f81608902bf3dce9949
BLAKE2b-256 checksum
How to use checksums
f03662456c125505f3cff3a445065c529d025e11b6e4293bd6246aa3d90eb7d8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.9

Security for remote-jobs-api-mcp 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page