npm package: @revolutionai/mcp-server
Description: revolutionAI MCP server — hire developers from Claude Desktop or Claude Code
Author: revolutionAI
Latest version: 0.1.1

# @revolutionai/mcp-server

The official [Model Context Protocol](https://modelcontextprotocol.io) server for [revolutionAI](https://revolutionai.io) — hire and work with AI developers directly from Claude Code, Claude Desktop, or any MCP-compatible AI assistant.

## Quick start

### Claude Code

```bash
claude mcp add revolutionai -- npx -y @revolutionai/mcp-server
```

Set your API key:

```bash
export REVOLUTIONAI_API_KEY=rai_your_key_here
```

### Claude Desktop / Cursor

Add to your MCP config (`claude_desktop_config.json` or `.mcp.json`):

```json
{
  "mcpServers": {
    "revolutionai": {
      "command": "npx",
      "args": ["-y", "@revolutionai/mcp-server"],
      "env": {
        "REVOLUTIONAI_API_KEY": "rai_your_key_here"
      }
    }
  }
}
```

## Get your API key

Generate an API key at [revolutionai.io/settings](https://revolutionai.io/settings/api-keys). Keys start with `rai_` and support `read` and `write` scopes.

## Tools (21)

### Discovery

| Tool | Scope | Description |
|------|-------|-------------|
| `search_talent` | read | Search developers by skills, budget, availability, rating |
| `get_talent_profile` | read | Get a developer's full profile and project history |
| `list_skills` | read | Browse 300+ skills across 8 categories |

### Projects

| Tool | Scope | Description |
|------|-------|-------------|
| `scope_project` | read | AI-estimated budget, timeline, and milestone breakdown |
| `create_project` | write | Create a new hiring project |
| `update_project` | write | Update project details or publish/cancel |
| `list_projects` | read | List your projects with status filter |

### Engagement

| Tool | Scope | Description |
|------|-------|-------------|
| `get_matches` | read | AI-ranked developer matches scored across 5 dimensions |
| `hire_developer` | write | Create contract with milestones and Stripe payment |
| `complete_engagement` | write | Approve milestones, request revision, or dispute |
| `submit_milestone` | write | Submit completed milestone for client review |
| `list_contracts` | read | List contracts with milestone progress |

### Contributor

| Tool | Scope | Description |
|------|-------|-------------|
| `list_open_projects` | read | Browse open projects available for proposals |
| `submit_proposal` | write | Submit a proposal with cover letter and milestones |
| `get_earnings` | read | View earnings summary by period |
| `send_message` | write | Send a message on a contract thread |
| `list_messages` | read | List messages on a contract |
| `submit_review` | write | Rate and review a completed contract |
| `update_profile` | write | Update your developer profile, skills, and rates |

### Account

| Tool | Scope | Description |
|------|-------|-------------|
| `get_dashboard` | read | Account overview: projects, contracts, spend |
| `search_docs` | read | Search platform documentation |

## Example prompts

```
"Find me a senior Next.js developer available full-time with 4.5+ rating"

"Scope a project: build a real-time dashboard with Stripe billing"

"Show me open projects that need React and Node.js skills"

"Submit my proposal for project proj_abc with a $5,000 budget"

"What are my earnings this month?"
```

## Authentication

| Scope | Access |
|-------|--------|
| `read` | Search talent, view profiles, scope projects, browse skills, view dashboard |
| `write` | Everything in read, plus: create projects, hire, manage milestones, submit proposals, send messages, update profile |

## Rate limits

| Plan | Requests/min | Concurrent |
|------|-------------|------------|
| Free | 100 | 5 |
| Pro | 500 | 20 |
| Enterprise | Unlimited | Unlimited |

## Environment variables

| Variable | Required | Description |
|----------|----------|-------------|
| `REVOLUTIONAI_API_KEY` | Yes | Your API key (starts with `rai_`) |
| `REVOLUTIONAI_SERVER_URL` | No | Override server URL (default: `https://mcp.revolutionai.io`) |

## How it works

This package is a thin stdio-to-SSE bridge (~80 lines). It connects Claude's stdio transport to the hosted revolutionAI MCP server over SSE. All infrastructure runs server-side — you only need your API key.

```
Claude Desktop/Code <-> stdio <-> proxy (this package) <-> SSE <-> revolutionai server
```

## Links

- [Full documentation](https://revolutionai.io/docs/mcp)
- [Get API key](https://revolutionai.io/settings/api-keys)
- [GitHub](https://github.com/revolutionai/revolutionai2)
- [Support](mailto:hello@revolutionai.io)

## License

MIT