@gera-services/mcp-gerajobs

@gera-services/mcp-gerajobs

MCP (Model Context Protocol) server for GeraJobs — part of Gera Systems.

MCP server for GeraJobs local job marketplace — search jobs, apply, post listings, and browse local opportunities across 50+ countries.

Enables AI assistants (Claude, ChatGPT, Gemini, etc.) to interact directly with GeraJobs on behalf of the user.

Installation

npm install @gera-services/mcp-gerajobs

Or run ad-hoc via npx:

npx @gera-services/mcp-gerajobs

Usage with Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "gerajobs": {
      "command": "npx",
      "args": ["@gera-services/mcp-gerajobs"]
    }
  }
}

With a custom API endpoint

{
  "mcpServers": {
    "gerajobs": {
      "command": "npx",
      "args": ["@gera-services/mcp-gerajobs"],
      "env": {
        "GERAJOBS_API_URL": "https://gerajobs-production.up.railway.app/gerajobs"
      }
    }
  }
}

Configuration

Environment Variable	Description	Default
GERAJOBS_API_URL	Base URL for the GeraJobs API	https://gerajobs-production.up.railway.app/gerajobs

Available Tools

This server exposes GeraJobs capabilities as MCP tools. Read-only tools (search, browse, list) work without authentication. Mutating tools (booking, purchasing, submitting) require a user bearer token passed via an auth_token parameter.

For the complete list of tools and their schemas, start the server and inspect it via an MCP-compatible client, or see the source at src/server.ts.

Multi-Country Support

GeraJobs operates across 50+ countries. Most tools accept a country parameter (ISO 3166-1 alpha-2, e.g. GB, US, GE, UG, KE) to scope results.

About Gera Systems

GeraJobs is a product of Gera Services Ltd — a worldwide platform building 22 verticals across healthcare, commerce, payments, and more. All products share a unified identity via GeraCoins and single sign-on.

License

MIT — see LICENSE.