Model Context Protocolnpm v0.1.0VS CodeOpenAI

Hire developers from Claude Code

The revolutionAI MCP server lets AI assistants search talent, scope projects, and manage the full hiring workflow — directly from your IDE.

claude mcp add revolutionai -- npx -y @revolutionai/mcp-server

Sign up to generate your API key.

What you can do

29 tools across 6 categories — everything you need to hire and work as an AI developer without leaving your editor.

Search & discover talent

Browse 300+ skills, filter by rate, availability, timezone, and ratings. Get full developer profiles with project history.

Jobs & bidding

Post jobs standalone or linked to projects. Contributors browse and bid, you review and accept — the best match gets assigned automatically.

Smart matching engine

Multi-dimensional scoring across skills (40%), rate (20%), availability (15%), rating (15%), and experience (10%).

Full hiring workflow

Create projects, hire developers, manage milestones, approve deliverables, and release payments — all from your AI assistant.

Contributor tools

Browse open jobs, submit bids and proposals, deliver milestones, track earnings, message clients, and manage your developer profile.

Quick start

Get up and running in under 2 minutes.

1

Install the MCP server

Claude Code
claude mcp add revolutionai -- npx -y @revolutionai/mcp-server

Or add manually to claude_desktop_config.json / .mcp.json:

json
{
  "mcpServers": {
    "revolutionai": {
      "command": "npx",
      "args": ["-y", "@revolutionai/mcp-server"],
      "env": {
        "REVOLUTIONAI_API_KEY": "rai_your_key_here"
      }
    }
  }
}
2

Get your API key

Generate an API key from your account settings page. Keys start with rai_ and support read and write scopes.

3

Start using tools

Example prompt
"Find me a senior Next.js developer available
full-time with at least 4.5 rating"

→ Claude calls search_talent with:
  skills: ["Next.js"]
  availability: "available"
  min_rating: 4.5

→ Returns ranked developers with rates,
  reviews, and availability

Tool reference

All 29 tools grouped by category. Click a tool to see its parameters.

Discovery

Search and browse talent, skills, and profiles

Projects

Create and manage hiring projects (jobs link to projects via project_id)

Jobs

Create job postings, manage bids, and assign contributors

Engagement

Match, hire, and manage developer contracts

Contributor

Tools for developers: submit proposals, manage earnings, and communicate with clients

Account

Dashboard overview and platform documentation

Typed client library

Use our TypeScript client for direct programmatic access. Full type safety with Zod-validated responses.

typescript — Hiring (client side)
import { RevolutionAIClient } from "@revolutionai/mcp-server/client";

const client = await RevolutionAIClient.createInProcess({
  apiKey: process.env.REVOLUTIONAI_API_KEY!,
});

// Search for developers with full type safety
const results = await client.searchTalent({
  skills: ["TypeScript", "Next.js", "PostgreSQL"],
  availability: "available",
  min_rating: 4.5,
});

// Create a project and post a job on it
const project = await client.createProject({
  title: "Real-time dashboard with Stripe billing",
  description: "Build a modern dashboard with live data and payment integration",
  skills_needed: ["React", "Stripe", "PostgreSQL"],
  budget_min: 500000, budget_max: 2500000,
});

await client.createJob({
  project_id: project.id,
  title: "Senior React Developer",
  description: "Implement dashboard UI with real-time updates",
  skills_needed: ["React", "TypeScript"],
  budget_min: 300000, budget_max: 1500000,
});
typescript — Contributing (developer side)
// Browse open jobs matching your skills
const jobs = await client.browseJobs({
  skills: ["React", "Node.js"],
  budget_min: 300000,  // $3,000+
});

// Submit a bid on a job
await client.submitBid({
  job_id: jobs.jobs[0].id,
  hours: 40,
  hourly_rate_cents: 15000,  // $150/hr
  cover_letter: "I have 5 years of React experience...",
});

// Or submit a full proposal for a project
await client.submitProposal({
  project_id: "proj_abc",
  amount_cents: 500000,
  estimated_hours: 40,
  cover_letter: "I have 5 years of React experience...",
  milestones: [
    { title: "Setup & scaffolding", description: "...", amount_cents: 150000, estimated_days: 5 },
    { title: "Core features",       description: "...", amount_cents: 250000, estimated_days: 10 },
    { title: "Testing & deploy",    description: "...", amount_cents: 100000, estimated_days: 5 },
  ],
});

// Submit completed work & track earnings
await client.submitMilestone({ milestone_id: "ms_123", deliverables: "PR #42 merged" });
const earnings = await client.getEarnings({ period: "month" });

Authentication & security

API keys with granular scopes and built-in rate limiting.

API key scopes

readRead-only access

Search talent, view profiles, browse jobs/skills, list bids, view dashboard, search docs.

writeFull access

Everything in read, plus: create/update projects, create/update jobs, submit bids, hire developers, manage milestones, release payments, submit proposals, send messages, submit reviews, update profile.

Security features

  • API keys prefixed with rai_ for easy identification
  • Granular read/write scope enforcement per tool
  • Ownership validation on all write operations
  • Rate limiting: 100 req/min (free), 500 (pro), unlimited (enterprise)
  • All data encrypted in transit (TLS 1.3)
  • Stripe-powered escrow for milestone payments
  • Audit logs for all API key usage

Rate limits by plan

PlanRequests / minConcurrentScopes
Free1005read
Pro50020readwrite
EnterpriseUnlimitedUnlimitedreadwrite

Ready to get started?

Install from npm, generate your API key, and start hiring developers directly from Claude Code, Cursor, or any MCP-compatible AI assistant.

claude mcp add revolutionai -- npx -y @revolutionai/mcp-server