MCP Server v2.0

Connect Your AI Agent to Armenia's Job Market

workx.am exposes a public MCP (Model Context Protocol) server. Any AI agent - Claude, ChatGPT, Gemini, or custom - can search jobs, companies, candidates, and salary data in real time.

MCP Endpoint

https://workx.am/mcp

No authentication required Read-only & safe Armenian & English

Connect

Pick the config that matches your MCP client. Most modern clients work with Option 1 - use Option 2 only if your client doesn't support remote HTTP servers yet.

Option 1 - Remote URL Recommended

For clients with native Streamable HTTP transport support.

Supported: Cursor, Windsurf, Continue, VS Code MCP extension, Claude Desktop (latest)

{ "mcpServers": { "workx-jobs": { "url": "https://workx.am/mcp" } } }

Option 2 - stdio bridge

For older clients that only support stdio (uses mcp-remote to bridge stdio to our HTTPS endpoint).

Supported: Claude Desktop (older versions), any stdio-only MCP client

{ "mcpServers": { "workx-jobs": { "command": "npx", "args": ["-y", "mcp-remote", "https://workx.am/mcp"] } } }

12 Tools Available

All read-only

search-jobs

Search active job listings by keyword, profession, city, salary, work type

get-job-details

Get full job details by ID or slug - all languages, company info, requirements

search-companies

Search companies by name, industry, location, or size

get-company-details

Get detailed company profile - description, size, industry, website

search-candidates

Search visible candidate profiles by profession, skills, city

get-candidate-profile

Get a candidate public profile - experience, skills, education

get-salary-insights

Aggregated salary data by profession and city

list-professions

List available job categories and professions

list-industries

List available industries

list-locations

List cities with country info

list-skills

List available skills, optionally filtered by category

get-platform-stats

Platform-wide statistics - users, jobs, companies, CVs

Guided Prompts

job-search

Guided workflow: find jobs matching your criteria - profession, location, salary, experience level

company-research

Research a company - profile, open positions, industry standing

career-advice

Career guidance using real market data - salary comparisons, skill gaps, transition advice

Resources

workx://resources/platform-overview

Platform stats, industries, locations

workx://resources/job-market-overview

Live market snapshot - trending professions, salaries

workx://resources/style-guidelines

Design system colors, typography, components

Discovery

/.well-known/mcp/server-card.json

MCP Server Card (SEP-1649)

/.well-known/mcp.json

MCP Discovery (fallback)

/.well-known/ai-plugin.json

AI Plugin Manifest

/.well-known/agents.json

Agent Discovery

Privacy & Safety

All tools are read-only. No personal contact information (email, phone) is exposed. Candidate profiles show first name only. Salary data is aggregated (minimum 3 data points). Rate limited to 60 requests/minute.