MCP Image Metadata Server

MCP server for extracting rich metadata from images, monetized via x402 payments.

Features

• EXIF extraction - Camera make/model, lens, ISO, aperture, shutter speed, focal length

• GPS data - Latitude, longitude, altitude

• IPTC/XMP - Keywords, captions, copyright, credit

• File info - Dimensions, format, color depth, DPI, file size

• Color analysis - Color profile detection

• Manipulation detection - Analyze images for signs of editing

• Freemium - 50 free requests per wallet

• x402 payments - Accept USDC for paid requests

Quick Start

Local (Stdio)

npm install
npm run build
npm run dev

Docker

docker build -t mcp-image-metadata .
docker run -p 3000:3000 mcp-image-metadata

Environment Variables

HTTP API

When PORT is set, the server runs as an HTTP API:

Endpoints

POST /mcp    - MCP JSON-RPC
GET  /health - Health check

Example Usage

# List tools
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# Extract metadata
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "extract_image_metadata",
      "arguments": {
        "imageUrl": "https://example.com/photo.jpg",
        "payer": "0xYourWalletAddress"
      }
    }
  }'

Available Tools

Deployment

Render

1. Push to GitHub

2. Connect repo on render.com

3. Uses render.yaml - auto-configured

Railway

npm install -g railway
railway login
railway init
railway deploy

Fly.io

fly launch
fly deploy

Pricing

Freemium

• First 50 requests free per wallet address

• After 50, requires x402 payment

• Usage tracked in memory

x402 Payment Flow

1. Agent calls tool with paymentHeader (x402 payment string)

2. Server verifies via xpay facilitator

3. If valid, returns metadata; if invalid, returns error

4. USDC transfers to your wallet on Base

Tech Stack

• Node.js 20+

• TypeScript

• @modelcontextprotocol/sdk

• Sharp (image processing)

• ExifReader (metadata parsing)

• Express (HTTP server)

License

MIT