50c Documentation

AI tools for your IDE via the Model Context Protocol.

Quick Start

npx 50c install

Auto-configures MCP for Claude Desktop, Cursor, VS Code, Windsurf, and more.

Installation

50c works as both an MCP server (for IDEs) and a CLI tool.

Automatic Setup

npx 50c install

This detects installed IDEs and adds 50c to their MCP configuration.

Global Install (Optional)

npm install -g 50c

API Key Setup

Get your API key at 50c.ai, then set it as an environment variable.

Windows

  1. Open System Properties → Environment Variables
  2. Add new User variable: FIFTYC_API_KEY
  3. Set value to your API key
  4. Restart your IDE

Mac / Linux

Add to your shell profile (~/.zshrc or ~/.bashrc):

export FIFTYC_API_KEY="your-api-key-here"

Then restart your terminal and IDE.

Claude Desktop

Config location:

  • Mac: ~/.claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "50c": {
      "command": "npx",
      "args": ["-y", "50c"],
      "env": {
        "FIFTYC_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Config: ~/.cursor/mcp.json

{
  "mcpServers": {
    "50c": {
      "command": "npx",
      "args": ["-y", "50c"],
      "env": {
        "FIFTYC_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code

Config: ~/.vscode/mcp.json

{
  "servers": {
    "50c": {
      "command": "npx",
      "args": ["-y", "50c"],
      "env": {
        "FIFTYC_API_KEY": "your-api-key"
      }
    }
  }
}

Windsurf

Config: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "50c": {
      "command": "npx",
      "args": ["-y", "50c"],
      "env": {
        "FIFTYC_API_KEY": "your-api-key"
      }
    }
  }
}

Zed

Config: ~/.config/zed/settings.json

{
  "context_servers": {
    "50c": {
      "command": {
        "path": "npx",
        "args": ["-y", "50c"],
        "env": {
          "FIFTYC_API_KEY": "your-api-key"
        }
      }
    }
  }
}

Other IDEs

50c auto-install supports:

  • Verdent
  • Cline (VS Code extension)
  • Continue
  • Roo Code
  • Augment
  • JetBrains IDEs (IntelliJ, PyCharm, etc.)

For hosted IDEs (Bolt.new, Replit, Lovable, v0.dev):

  1. Go to MCP/Tools settings
  2. Add command: npx -y 50c
  3. Set env: FIFTYC_API_KEY=your-key

Genius

$0.50 Deep problem solving

Advanced reasoning for complex problems. Uses chain-of-thought to break down and solve multi-step challenges.

# CLI
50c genius "How do I scale PostgreSQL to handle 10M rows efficiently?"

# MCP Tool
genius(problem: "your complex problem")

Genius Plus

$0.65 Reasoning + code execution

Combines deep reasoning with Python execution. Solves problems that require both thinking and computation.

# MCP Tool
genius_plus(problem: "Calculate optimal pricing for 3 tiers with 40% margin")

Hints

$0.05 5 brutal 2-word hints

Quick, punchy hints when you're stuck. No fluff, just direction.

# CLI
50c hints "api design patterns"

# MCP Tool
hints(query: "database optimization")

Hints Plus

$0.10 10 expanded 4-word hints
50c hints+ "microservices architecture"

Compute

$0.02 Python sandbox execution

Execute Python code in a sandboxed environment. 10 second timeout.

# MCP Tool
compute(code: "print(sum(range(100)))")

Web Tools

Web Search

Free Search the web
web_search(query: "latest Next.js features")

Page Fetch

Free Fetch any URL
page_fetch(url: "https://example.com")

Domain Check

Free Check domain availability
domain_check(domain: "coolstartup.com")

Creative Tools

Quick Vibe

$0.05 3 unconventional ideas
50c vibe "building a developer tool"

Mind Opener

$0.08 5 curious angles
mind_opener(problem: "user onboarding")

Roast

$0.05 Brutal code review
roast(code: "function add(a,b) { return a + b }")

One Liner

$0.02 8-word elevator pitch
one_liner(product: "AI-powered code review tool")

Name It

$0.03 5 names + domain check
name_it(does: "helps developers write better docs")

Price It

$0.05 SaaS pricing strategy
price_it(product: "API analytics dashboard")

CLI Usage

Use 50c directly from your terminal:

# Set API key
export FIFTYC_API_KEY="your-key"

# Run commands
50c genius "your problem"
50c hints "your topic"
50c vibe "your idea"

CLI Commands

Command Cost Description
install-Auto-configure IDEs
genius$0.50Deep problem solving
hints$0.055 brutal hints
hints+$0.1010 expanded hints
vibe$0.053 unconventional ideas
one-liner$0.02Elevator pitch
roast$0.05Code review
name-it$0.03Name generator
price-it$0.05Pricing strategy
compute$0.02Python execution

REST API

Direct API access at https://api.50c.ai

Authentication

Authorization: Bearer your-api-key

Check Balance

GET /v1/balance

Response:
{
  "credits": 850,
  "plan_credits": 1000,
  "reset_at": "2025-02-01",
  "plan": "starter"
}

Call a Tool

POST /v1/genius
Content-Type: application/json

{
  "problem": "How do I implement rate limiting?"
}

Response:
{
  "result": "...",
  "_meta": {
    "credits_used": 10,
    "credits_remaining": 840,
    "latency_ms": 2341
  }
}

Pricing

Credit-based pricing. All plans include full access to every tool.

Starter

$29/mo

1,000 credits

Pro

$99/mo

10,000 credits

Enterprise

$499/mo

100,000 credits

Get your API key →