Skip to content

Robocular/frostbyte-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

frostbyte-mcp

MCP server that gives AI agents access to 40+ developer APIs through one gateway. Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

Tools

Tool Description
geo_lookup IP geolocation — country, city, coordinates, timezone, ISP
crypto_price Live cryptocurrency prices — BTC, ETH, SOL, and 40+ tokens
dns_lookup DNS records — A, AAAA, MX, TXT, NS, CNAME, SOA
whois_lookup Domain WHOIS/RDAP data — registrar, dates, nameservers
take_screenshot Website screenshots — PNG, multiple viewports, dark mode
scrape_url Web scraping — extract text, markdown, or HTML from any URL
run_code Code execution — JavaScript, Python, TypeScript, Bash
search_web Web search — structured results with titles and snippets
shorten_url URL shortener — custom slugs, expiration, click analytics
generate_pdf PDF generation — from HTML, URL, or Markdown
create_paste Pastebin — code sharing with syntax highlighting
transform_data Data conversion — JSON, CSV, XML, YAML, TSV, Markdown
check_domain Domain availability — check across multiple TLDs

Quick Start

Remote Server (no install needed)

Connect directly via URL — works with Claude, ChatGPT, Cursor, VS Code, and any MCP client:

SSE endpoint: https://frostbyte-mcp.167.148.41.86.nip.io/sse

Streamable HTTP endpoint: https://frostbyte-mcp.167.148.41.86.nip.io/mcp

Claude Desktop / Claude.ai

Go to Settings > Connectors > Add Custom Connector:

  • Name: Frostbyte
  • URL: https://frostbyte-mcp.167.148.41.86.nip.io/sse

Claude Code

claude mcp add --transport http "frostbyte" https://frostbyte-mcp.167.148.41.86.nip.io/sse

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "frostbyte": {
      "url": "https://frostbyte-mcp.167.148.41.86.nip.io/sse"
    }
  }
}

VS Code

Add to VS Code settings.json:

{
  "mcp": {
    "servers": {
      "frostbyte": {
        "type": "http",
        "url": "https://frostbyte-mcp.167.148.41.86.nip.io/sse"
      }
    }
  }
}

ChatGPT

Go to Settings > Connectors > Create:

  • Name: Frostbyte
  • URL: https://frostbyte-mcp.167.148.41.86.nip.io/sse

Local Server (stdio)

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "frostbyte": {
      "command": "node",
      "args": ["/path/to/frostbyte-mcp/src/index.js"],
      "env": {
        "FROSTBYTE_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor / Windsurf

Add to your MCP settings:

{
  "frostbyte": {
    "command": "node",
    "args": ["/path/to/frostbyte-mcp/src/index.js"],
    "env": {
      "FROSTBYTE_API_KEY": "your-api-key"
    }
  }
}

npx (no install)

{
  "mcpServers": {
    "frostbyte": {
      "command": "npx",
      "args": ["-y", "github:OzorOwn/frostbyte-mcp"],
      "env": {
        "FROSTBYTE_API_KEY": "your-api-key"
      }
    }
  }
}

Get an API Key

# Free — 200 credits, no signup
curl -X POST https://agent-gateway-kappa.vercel.app/api/keys/create

Or omit FROSTBYTE_API_KEY — the server auto-creates a free key on startup.

Examples

Once connected, your AI agent can:

  • "What's the geolocation of 1.1.1.1?" → calls geo_lookup
  • "Take a screenshot of https://news.ycombinator.com" → calls take_screenshot
  • "What's the current Bitcoin price?" → calls crypto_price
  • "Run this Python code: print(sum(range(100)))" → calls run_code
  • "Scrape the content from https://example.com" → calls scrape_url
  • "Look up DNS records for github.com" → calls dns_lookup
  • "Convert this CSV to JSON: name,age\nAlice,30\nBob,25" → calls transform_data

Environment Variables

Variable Description Default
FROSTBYTE_API_KEY API key for authentication Auto-created (free tier)
FROSTBYTE_BASE_URL Gateway URL https://agent-gateway-kappa.vercel.app

Requirements

  • Node.js 18+
  • No other dependencies (just @modelcontextprotocol/sdk)

Full API Documentation

The MCP server proxies to the Frostbyte API Gateway which provides 40+ services. For full API docs, see:

License

MIT