Model Context Protocolnpm v0.1.0

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

21 tools across 5 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.

AI-powered project scoping

Describe your project in plain English. Get estimated budget, timeline, recommended skills, and milestone breakdown instantly.

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

Find open projects, submit 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 21 tools grouped by category. Click a tool to see its parameters.

Discovery

Search and browse talent, skills, and profiles

Projects

Scope, create, and manage hiring projects

Engagement

Match, hire, and manage developer contracts

Contributor

Tools for developers: find projects, 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,
});

// AI-powered project scoping
const scope = await client.scopeProject({
  description: "Build a real-time dashboard with Stripe billing",
});

console.log(scope.formatted.budget);    // "$5,000-$25,000"
console.log(scope.formatted.duration);  // "4 weeks"
console.log(scope.recommended_skills);  // ["React", "Stripe", ...]
typescript — Contributing (developer side)
// Browse open projects matching your skills
const projects = await client.listOpenProjects({
  skills: ["React", "Node.js"],
  budget_min: 300000,  // $3,000+
});

// Submit a proposal
await client.submitProposal({
  project_id: projects.projects[0].id,
  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, scope projects, browse skills, view dashboard, search docs.

writeFull access

Everything in read, plus: create/update projects, hire developers, manage milestones, release payments, submit proposals, submit milestones, 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