50c Documentation

100+ AI tools for your IDE via the Model Context Protocol.

Web search, secrets vault, domain management, deep reasoning, code execution, and more.

npx 50c install

Installation

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

Automatic Setup (Recommended)

npx 50c install

Detects installed IDEs and automatically adds 50c to their MCP configuration.

Global Install

npm install -g 50c

Install globally to use CLI commands directly (e.g., 50c hints "topic").

Verify Installation

npx 50c status

API Key Setup

Get your API key at 50c.ai/subscribe. Free local tools work without a key via npx 50c.

Option 1: Environment Variable (Recommended)

$env:FIFTYC_API_KEY = "cv_your_api_key_here"

export FIFTYC_API_KEY="cv_your_api_key_here"

Option 2: CLI Config

npx 50c config key cv_your_api_key_here

Stores in ~/.50c/config.json

C Claude Desktop

Config location:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Cu Cursor

Config: ~/.cursor/mcp.json

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

VS VS Code (GitHub Copilot)

Requires GitHub Copilot extension with MCP support. Config: .vscode/mcp.json in workspace or ~/.vscode/mcp.json globally.

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

W Windsurf (Codeium)

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

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

Z Zed

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

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

V Verdent

Config: ~/.verdent/mcp.json

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

Cl Cline / Roo Code

Open Cline settings in VS Code → MCP Servers → Add Server

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

L Lovable

Lovable supports MCP servers via project settings.

1. Open your Lovable project
2. Go to Settings → Integrations → MCP Servers
3. Click Add MCP Server
4. Use the remote HTTP endpoint:

# Endpoint
https://api.50c.ai/mcp

# Headers
Authorization: Bearer cv_your_api_key

Or use the REST API directly in your Lovable app code.

R Replit

For Replit Agent or Ghostwriter with MCP support:

1. Add FIFTYC_API_KEY to Replit Secrets
2. In your .replit file or shell:

# Install and run MCP server
npx 50c

For direct API usage in your code:

import os
import requests

response = requests.post(
    "https://api.50c.ai/v1/tools/web_search",
    headers={"Authorization": f"Bearer {os.environ['FIFTYC_API_KEY']}"},
    json={"query": "latest AI news"}
)
print(response.json())

B Bolt.new

Bolt.new supports external APIs. Use the REST API:

// In your Bolt.new project
const response = await fetch('https://api.50c.ai/v1/tools/genius', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer cv_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ problem: 'How do I optimize this algorithm?' })
});

const result = await response.json();

v0 v0.dev

v0 generates React components. Use 50c API in your generated code:

// Server action or API route
'use server'

export async function search(query: string) {
  const res = await fetch('https://api.50c.ai/v1/tools/web_search', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.FIFTYC_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ query })
  });
  return res.json();
}

FREE Free Tier - 40+ Tools

Free local tools included with npx 50c. No API key required.

View all free tools →

STARTER $29/mo Starter Tier - Paid AI Tools

1,000 credits/month. All Free tools plus:

View all Starter tools →

PRO $99/mo Pro Tier - Advanced AI

10,000 credits/month. All Starter tools plus:

View all Pro tools →

ENTERPRISE $499/mo Enterprise Tier - S-Tier AI

100,000 credits/month. All Pro tools plus:

WHM/cPanel Pack (Enterprise Only)

View all Enterprise tools →

Vault Pack - Encrypted Secrets

Local encrypted vault for API keys, tokens, and credentials. AES-256 encryption.

# Initialize vault
vault_init passphrase="your-secure-passphrase"

# Add a secret
vault_add name="OPENAI_KEY" value="sk-..."

# Retrieve secret
vault_get name="OPENAI_KEY"

# Store proxies
vault_add_proxies name="residential" proxy_list="ip:port:user:pass\n..."

Dewey Pack - Knowledge Index

Personal knowledge base for files, articles, books, ideas, and snippets.

# Add an item
dewey_add title="React Patterns" type="article" tags=["react","patterns"]

# Search
dewey_search query="react hooks"

# List with filters
dewey_list type="book" min_rating=4

Cloudflare Pack - DNS & CDN

Manage Cloudflare zones, DNS, SSL, and caching. Requires CF API token in vault.

# Store your Cloudflare token
vault_add name="CF_API_TOKEN" value="your-cf-token"

# List zones
cf_list_zones

# Create DNS record
cf_create_dns zone_id="xxx" type="A" name="api" content="1.2.3.4" proxied=true

# Point domain to server
cf_point_to_server zone_id="xxx" ip="1.2.3.4"

WHM/cPanel Pack - Server Management

Enterprise only. Manage WHM servers, cPanel accounts, email, databases.

# Store WHM credentials
vault_add name="WHM_HOST" value="server.example.com"
vault_add name="WHM_TOKEN" value="your-api-token"

# List accounts
whm_list_accounts

# Create account
whm_create_account username="newuser" domain="example.com"

# Run AutoSSL
whm_autossl_run user="newuser"

Context Pack - Token Management

Pro+. Analyze, compress, and optimize LLM context windows.

# Check context health
context_health text="your long context..."

# Compress context
context_compress text="verbose conversation..."

# Extract key info
context_extract text="..." extract_type="decisions"

# Reposition for attention
context_reposition text="..."

Math Discovery Pack

Pro+. Mathematical exploration, conjecture testing, pattern discovery.

# Explore a math expression
bcalc expression="sum of reciprocals of primes" mode="explore"

# Deep explanation
bcalc_why expression="why does e^(i*pi) = -1"

# Chaos fingerprinting
chaos_fingerprint limit=10000

# Novel sequence
echo_sequence n=100

Installation

# Via npx (no install)
npx 50c [command]

# Global install
npm install -g 50c
50c [command]

Commands

REST API

Base URL

https://api.50c.ai/v1

Authentication

Authorization: Bearer cv_your_api_key

Endpoints

GET /balance

Response:
{
  "credits": 1000,
  "tier": "starter"
}

POST /tools/{tool_name}
Content-Type: application/json

{
  "param1": "value1",
  "param2": "value2"
}

Response:
{
  "result": "...",
  "cost": 0.05,
  "remaining_credits": 995
}

curl -X POST https://api.50c.ai/v1/tools/web_search \
  -H "Authorization: Bearer cv_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "latest AI news"}'

curl -X POST https://api.50c.ai/v1/tools/genius \
  -H "Authorization: Bearer cv_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"problem": "How do I optimize a React app for performance?", "research": true}'

Pricing

Need more credits? Top-up anytime →