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
- Open System Properties → Environment Variables
- Add new User variable:
FIFTYC_API_KEY - Set value to your API key
- 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):
- Go to MCP/Tools settings
- Add command:
npx -y 50c - Set env:
FIFTYC_API_KEY=your-key
Genius
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
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
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
50c hints+ "microservices architecture"
Compute
Execute Python code in a sandboxed environment. 10 second timeout.
# MCP Tool
compute(code: "print(sum(range(100)))")
Web Tools
Web Search
web_search(query: "latest Next.js features")
Page Fetch
page_fetch(url: "https://example.com")
Domain Check
domain_check(domain: "coolstartup.com")
Creative Tools
Quick Vibe
50c vibe "building a developer tool"
Mind Opener
mind_opener(problem: "user onboarding")
Roast
roast(code: "function add(a,b) { return a + b }")
One Liner
one_liner(product: "AI-powered code review tool")
Name It
name_it(does: "helps developers write better docs")
Price It
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.50 | Deep problem solving |
hints | $0.05 | 5 brutal hints |
hints+ | $0.10 | 10 expanded hints |
vibe | $0.05 | 3 unconventional ideas |
one-liner | $0.02 | Elevator pitch |
roast | $0.05 | Code review |
name-it | $0.03 | Name generator |
price-it | $0.05 | Pricing strategy |
compute | $0.02 | Python 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