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:

API Catalog
Getting Started Guide
AI Agent Starter Kit — template repo with Python + Node.js examples
JavaScript & Python SDK
OpenAPI Spec

License

MIT

frostbyte