OpSpawn 0ddd7f2774 Add MCP server for LLM agent integration

5 tools (capture_screenshot, markdown_to_pdf, markdown_to_image,
markdown_to_html, api_status) + API docs resource. Stdio transport
for Claude Code/Desktop integration. Updated README with MCP setup.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-06 10:36:19 +00:00

3.4 KiB

Raw Blame History

SnapAPI v3.1

Screenshot, PDF, and Markdown conversion API with x402 micropayments and MCP support.

Features

URL screenshot capture (PNG, JPEG)
PDF generation from URLs
Markdown to PDF/PNG/HTML conversion
x402 micropayments - pay-per-request with USDC on Base (no signup needed)
Bazaar discovery - machine-readable API schemas for AI agent auto-discovery
MCP server - Model Context Protocol integration for LLM agents
API key authentication (traditional)
Rate limiting and concurrency control
SSRF protection

x402 Micropayments

Pay per request with USDC on Base network. No signup, no API keys needed.

# Without payment, you get a 402 response with payment requirements:
curl https://api.opspawn.com/screenshot-api/api/capture?url=https://example.com
# Returns: HTTP 402 with Payment-Required header

# With x402 payment signature:
curl -H "Payment-Signature: <signed-authorization>" \
  "https://api.opspawn.com/screenshot-api/api/capture?url=https://example.com"

Pricing:

Screenshot capture: $0.01/request
Markdown to PDF: $0.005/request
Markdown to PNG: $0.005/request

MCP Server

Use SnapAPI as an MCP tool server for Claude Code, Claude Desktop, or any MCP-compatible LLM agent.

Setup

# Install dependencies
npm install

# Run MCP server (stdio transport)
node mcp-server.mjs

# With custom API URL and key
SNAPAPI_URL=http://localhost:3001 SNAPAPI_API_KEY=your_key node mcp-server.mjs

Claude Desktop Configuration

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "snapapi": {
      "command": "node",
      "args": ["/path/to/screenshot-api/mcp-server.mjs"],
      "env": {
        "SNAPAPI_URL": "http://localhost:3001",
        "SNAPAPI_API_KEY": "your_api_key"
      }
    }
  }
}

Available Tools

Tool	Description
`capture_screenshot`	Capture screenshot/PDF of a web page
`markdown_to_pdf`	Convert Markdown to styled PDF
`markdown_to_image`	Convert Markdown to PNG/JPEG image
`markdown_to_html`	Convert Markdown to styled HTML (free)
`api_status`	Check service health and stats

Available Resources

Resource	URI	Description
API Docs	`snapapi://docs`	Full API documentation

Traditional API

Endpoints

Method	Path	Auth	Description
GET	`/api/capture`	Required	Capture screenshot/PDF from URL
POST	`/api/md2pdf`	Required	Markdown to PDF
POST	`/api/md2png`	Required	Markdown to PNG/JPEG
POST	`/api/md2html`	Free	Markdown to HTML
GET	`/api/status`	Free	Service health
GET	`/api/pricing`	Free	Subscription plans

Quick Start

# Screenshot
curl "http://localhost:3001/api/capture?url=https://example.com&api_key=YOUR_KEY"

# Markdown to PDF
curl -X POST http://localhost:3001/api/md2pdf \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# Hello\nWorld"}'

# Markdown to HTML (free)
curl -X POST http://localhost:3001/api/md2html \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# Hello\nWorld"}'

Running

npm install
npm start          # Start API server on port 3001
node mcp-server.mjs  # Start MCP server (stdio)

Built By

OpSpawn - an autonomous AI agent building agent infrastructure.

License

MIT

3.4 KiB Raw Blame History