Remote Vibe Coding Jobs MCP Server

Model Context Protocol (MCP) server for the HireQL job search API. Search 630+ remote software jobs with advanced filters for tech stack, culture/vibe signals, salary, and experience level.

What is this?

This MCP server enables AI assistants (like Claude Desktop, Cursor, etc.) to search and explore remote developer jobs with strong culture/vibe signals. It provides three tools:

1. search_jobs - Search jobs with rich filters
2. get_job - Get full details for a specific job
3. job_market_stats - Get market statistics and trends

Installation

Via npx (Recommended)

No installation needed! Configure your MCP host to run:

npx @remotevibecodingjobs/mcp-server

Via npm install

npm install -g @remotevibecodingjobs/mcp-server

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "remote-vibe-coding-jobs": {
      "command": "npx",
      "args": [
        "@remotevibecodingjobs/mcp-server"
      ],
      "env": {
        "RVCJ_API_KEY": "your-api-key-here"
      }
    }
  }
}

Note: API key is optional for basic usage. Get an API key for higher rate limits and premium features.

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json or settings UI):

{
  "mcpServers": {
    "remote-vibe-coding-jobs": {
      "command": "npx",
      "args": ["@remotevibecodingjobs/mcp-server"],
      "env": {
        "RVCJ_API_KEY": "your-api-key-here"
      }
    }
  }
}

Other MCP Hosts

For any MCP-compatible host:

• Command: npx @remotevibecodingjobs/mcp-server
• Environment Variable: RVCJ_API_KEY (optional)
• Transport: stdio

Available Tools

search_jobs

Search remote software jobs with advanced filters.

Parameters:

• query (string, optional) - Search query for job titles, companies, or descriptions
• tech (string[], optional) - Filter by tech stack (e.g., ["typescript", "react", "node"])
• vibe (string[], optional) - Filter by culture signals (e.g., ["async", "remote-first", "flexible"])
• level (enum, optional) - Experience level: "junior", "mid", "senior", "staff", "principal"
• min_salary (number, optional) - Minimum salary in USD
• min_vibe_score (number, optional) - Minimum vibe score (0-10)
• limit (number, optional) - Results to return (default: 10, max: 50)

Example prompts:

• "Find me senior TypeScript jobs paying over $150k"
• "Show me async-first companies hiring React developers"
• "What remote Python jobs are available with high vibe scores?"

get_job

Get complete details for a specific job.

Parameters:

• id (string, required) - Job ID from search results

Example prompts:

• "Get details for job abc123"
• "Show me more about that first job"

job_market_stats

Get aggregate statistics about the remote job market.

No parameters required

Example prompts:

• "What are the stats on the remote job market?"
• "Show me market trends"
• "What tech stacks are most in demand?"

Example Conversation

You: "Find me remote TypeScript jobs at async-first companies with salaries over $120k"

Claude (using search_jobs):

Found 23 jobs:

**Senior TypeScript Engineer** at Acme Corp
📍 Remote (US)
💰 $130,000 - $170,000
📊 Senior
🔧 Tech: TypeScript, React, Node.js, PostgreSQL
✨ Vibe: async-first, remote-first, flexible-hours
⭐ Vibe Score: 9/10
🔗 https://remotevibecodingjobs.com/jobs/abc123
ID: abc123

...

You: "Tell me more about that first one"

Claude (using get_job):

Job Details:

**Senior TypeScript Engineer** at Acme Corp
[Full details including complete job description]

API Key

Get a free API key at remotevibecodingjobs.com/developers.

Without an API key: You can still use the server with rate limits
With an API key: Higher rate limits and access to all features

Set via the RVCJ_API_KEY environment variable in your MCP configuration.

Development

Local Setup

git clone <repo>
cd packages/mcp-server
npm install
npm run build

Testing

# Run the server directly
node dist/index.js

# Test with Claude Desktop or your MCP host

Building

npm run build

TypeScript will compile to dist/ and the binary will be executable.

Troubleshooting

Server doesn't appear in Claude Desktop

1. Verify your claude_desktop_config.json is valid JSON
2. Make sure the path is correct for your OS
3. Restart Claude Desktop completely
4. Check Claude Desktop logs: ~/Library/Logs/Claude/ (macOS)

API Errors

• 401 Unauthorized: Check your RVCJ_API_KEY is valid
• 429 Too Many Requests: You've hit rate limits, get an API key or wait
• 500 Server Error: API is having issues, try again later

Connection Issues

• Make sure you have Node.js 18+ installed: node --version
• Try running the command directly: npx @remotevibecodingjobs/mcp-server
• Check your internet connection

License

MIT

Links

• Remote Vibe Coding Jobs
• API Documentation
• Model Context Protocol
• MCP TypeScript SDK