Skip to main content

​
Overview

The WraithBytes MCP Server is an open-source server that exposes web acquisition capabilities through the Model Context Protocol (MCP), enabling integration with Claude, Cursor, VS Code, and other MCP-compatible AI tools.

​
Tools Provided

​
fetch_url

Fetch and parse any web page. Auto-detects the platform and applies the appropriate parser. Parameters:
ParameterTypeRequiredDescription
urlstringYesThe URL to fetch and parse
markdownbooleanNoReturn content as Markdown
jsonbooleanNoReturn structured JSON
include_linksbooleanNoExtract all links
include_htmlstringNo"cleaned" or "raw" HTML
image_urlsbooleanNoExtract image URLs
json_schemaobjectNoCustom extraction schema
ai_summarybooleanNoGenerate AI summary
ai_image_transcriptionbooleanNoTranscribe images
ai_audio_transcriptionbooleanNoTranscribe audio
filtersobjectNoPlatform-specific filters

​
get_fetch_results

Retrieve the history of past fetch results for your account. No parameters required.

​
Setup

​
Docker

docker run -p 2425:2425 \
  -e WRAITHBYTES_API_URL=https://web-acq.wraithbytes.com \
  wraithbytes/mcp-server

​
From Source

git clone https://github.com/wraithbytes/mcp-server.git
cd mcp-server
go run main.go

​
Environment Variables

VariableDefaultDescription
WRAITHBYTES_API_URLhttp://localhost:5201WraithBytes API base URL
WRAITHBYTES_SSE_ADDR:2425SSE server listen address

​
Authentication

The MCP server authenticates with the WraithBytes API using a Bearer token passed via the Authorization header on the SSE connection. Each MCP client session uses its own API key.

​
Claude Desktop Configuration

Add to your Claude Desktop MCP configuration: 
{
  "mcpServers": {
    "wraithbytes": {
      "url": "http://localhost:2425/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

​
Transport

The server uses SSE (Server-Sent Events) transport on port 2425 by default. This is compatible with all MCP clients that support SSE transport.