Is MCP Image Metadata free?

Yes, MCP Image Metadata is free to use.

How do I install MCP Image Metadata?

MCP Image Metadata supports both local and remote installation. For local use, install it via the provided package manager and add the configuration to your AI app. For remote access, add the server URL to your MCP configuration.

What credentials does MCP Image Metadata need?

MCP Image Metadata requires the following credentials or environment variables: PORT, X402_API_KEY, X402_WALLET_ADDRESS, X402_NETWORK, FREEMIUM_LIMIT. You can find setup instructions on the server detail page.

What AI apps work with MCP Image Metadata?

MCP Image Metadata uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

MCP Image Metadata MCP Server

by jicoing

Content & MediaUse Caution3.2LocalRemoteNew

Free

Extract EXIF, GPS, IPTC, XMP metadata from any image with freemium and x402 USDC payments.

About

MCP Image Metadata is a Model Context Protocol server that extracts rich metadata from images. It provides EXIF data (camera make/model, ISO, aperture, shutter speed), GPS coordinates, IPTC fields (keywords, captions, copyright), and XMP metadata. Features include 50 free requests per wallet, x402 payment integration for USDC, batch processing up to 50 images, manipulation detection for forensic analysis, and automatic file cleanup after processing. Perfect for AI agents, stock photo platforms, e-commerce product listings, marketing agencies, and digital forensics.

Security Report

3.2

Use Caution3.2High Risk

This MCP server implements image metadata extraction with x402 payment integration. While the core functionality is reasonable and permissions align with its purpose, there are several security concerns: unauthenticated file upload accepting arbitrary image files, inadequate input validation on file paths leading to path traversal vulnerabilities, in-memory freemium tracking that persists user state without proper isolation, and missing validation of payment headers before processing. The server also uses loose error handling that could leak sensitive information. These issues, combined with file system operations on untrusted paths, create meaningful risks for a production deployment. Supply chain analysis found 3 known vulnerabilities in dependencies (1 critical, 2 high severity).

7 files analyzed · 14 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

file_delete

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

HTTP server port. Default: runs in stdio mode if not set.Optional

Environment variable: PORT

xpay API key for payment processing. Get fromOptional

Environment variable: X402_API_KEY

Your Base USDC wallet address to receive payments.Optional

Environment variable: X402_WALLET_ADDRESS

base or base-sepolia. Default: base-sepolia.Optional

Environment variable: X402_NETWORK

Number of free requests per wallet. Default: 50.Optional

Environment variable: FREEMIUM_LIMIT

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Getting Started

Once installed, try these example prompts and explore these capabilities:

1"Extract metadata from my uploaded image" — Uploads and extracts all available metadata
2"Check if this image has been edited or manipulated" — Analyzes image for signs of editing
3"Get pricing information for this MCP server" — Returns pricing tiers and freemium status
4Tool: extract_image_metadata — Extract EXIF, GPS, IPTC, XMP from a single image
5Tool: extract_batch_metadata — Extract metadata from multiple images (max 50)
6Tool: detect_image_manipulation — Analyze image for manipulation signs
7Tool: get_pricing — Get current pricing and freemium status

Documentation

View on GitHub

From the project's GitHub README.

MCP Image Metadata Server

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

Live Demo

Server: https://mcp-image-metadata.onrender.com

Quick Start

1. Upload Image

curl -X POST https://mcp-image-metadata.onrender.com/upload \
  -F "image=@your-image.jpg"

Response:

{
  "success": true,
  "filePath": "/tmp/uploads/abc123.jpg",
  "fileName": "abc123.jpg",
  "originalName": "your-image.jpg",
  "size": 12345
}

2. Extract Metadata

curl -X POST https://mcp-image-metadata.onrender.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "extract_image_metadata",
      "arguments": {
        "imageUrl": "/tmp/uploads/abc123.jpg",
        "payer": "0xYourWalletAddress"
      }
    }
  }'

Response:

{
  "success": true,
  "data": {
    "file": {
      "width": 1920,
      "height": 1080,
      "format": "jpeg",
      "colorDepth": 3,
      "dpi": 72,
      "fileSize": 456789,
      "mimeType": "image/jpeg"
    },
    "exif": {
      "cameraMake": "Apple",
      "cameraModel": "iPhone 14 Pro",
      "dateTime": "2024:01:15 12:30:00"
    },
    "gps": {
      "latitude": 37.7749,
      "longitude": -122.4194
    }
  },
  "price": 0.002,
  "paymentStatus": "free",
  "freemiumRemaining": 49
}

API Endpoints

Endpoint	Method	Description
`/mcp`	POST	MCP JSON-RPC interface
`/upload`	POST	Upload image file
`/health`	GET	Health check

MCP Tools

1. extract_image_metadata

Extract EXIF, GPS, IPTC, XMP metadata from an image.

Arguments:

{
  "imageUrl": "/tmp/uploads/abc123.jpg",
  "includeOptions": {
    "includeGps": true,
    "includeColor": true,
    "includeThumbnail": false,
    "includeOcr": false,
    "includeDeepHash": false
  },
  "paymentHeader": "...",
  "payer": "0xYourWallet"
}

Response:

{
  "success": true,
  "data": { "file": {...}, "exif": {...}, "gps": {...} },
  "price": 0.002,
  "paymentStatus": "free",
  "freemiumRemaining": 50
}

2. extract_batch_metadata

Extract metadata from multiple images (max 50).

Arguments:

{
  "imageUrls": ["/tmp/uploads/1.jpg", "/tmp/uploads/2.jpg"],
  "options": { "includeGps": true },
  "paymentHeader": "...",
  "payer": "0xYourWallet"
}

3. detect_image_manipulation

Analyze image for signs of manipulation/editing.

Arguments:

{
  "imageUrl": "/tmp/uploads/abc123.jpg",
  "analysisLevel": "standard",
  "paymentHeader": "...",
  "payer": "0xYourWallet"
}

analysisLevel:

basic - Basic checks ($0.002)
standard - Standard analysis ($0.002)
forensic - Deep forensic analysis ($0.015)

4. get_pricing

Get current pricing tiers and freemium status.

Arguments:

{
  "payer": "0xYourWallet"
}

Response:

{
  "pricing": {
    "basic": { "tier": "basic", "price": 0.001 },
    "standard": { "tier": "standard", "price": 0.002 },
    "premium": { "tier": "premium", "price": 0.005 },
    "forensic": { "tier": "forensic", "price": 0.015 }
  },
  "freemium": { "limit": 50, "remaining": 49 }
}

Complete Usage Flow

Step 1: Upload Image

# Upload image
curl -X POST https://mcp-image-metadata.onrender.com/upload \
  -F "image=@photo.jpg"

Response:

{
  "success": true,
  "filePath": "/tmp/uploads/abc123.jpg"
}

Step 2: Extract Metadata

curl -X POST https://mcp-image-metadata.onrender.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "extract_image_metadata",
      "arguments": {
        "imageUrl": "/tmp/uploads/abc123.jpg",
        "payer": "0xYourWallet123"
      }
    }
  }'

Step 3: Get Updated Freemium Status

curl -X POST https://mcp-image-metadata.onrender.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "get_pricing",
      "arguments": {
        "payer": "0xYourWallet123"
      }
    }
  }'

Pricing

Tier	Price	Description
Basic	$0.001 USDC	File info, dimensions, color profile
Standard	$0.002 USDC	Basic + GPS, IPTC, XMP
Premium	$0.005 USDC	Standard + thumbnail, deep hash
Forensic	$0.015 USDC	Premium + manipulation analysis

Freemium

50 free requests per wallet address
After 50, requires x402 payment
Usage tracked in memory (resets on server restart)

x402 Payment Integration

For Agents/Apps

To make paid requests, include the paymentHeader:

{
  "name": "extract_image_metadata",
  "arguments": {
    "imageUrl": "/tmp/uploads/abc123.jpg",
    "payer": "0xYourWallet",
    "paymentHeader": "payment=v1_USDC_..."
  }
}

Payment Flow

Agent calls tool with x402 payment header
Server verifies payment via xpay facilitator
If valid → returns metadata
If invalid → returns error
USDC transfers to your wallet on Base

Environment Variables

Variable	Description	Default
`PORT`	HTTP server port	stdio mode
`NODE_ENV`	Environment	development
`X402_FACILITATOR_URL`	x402 payment relay	https://facilitator.xpay.sh
`X402_API_KEY`	xpay API key	-
`X402_WALLET_ADDRESS`	Your Base USDC wallet	-
`X402_NETWORK`	base or base-sepolia	base-sepolia
`FREEMIUM_LIMIT`	Free requests per wallet	50

Deployment

Render (Recommended)

Push to GitHub
Go to render.com → New → Web Service
Connect your repo
Configure:

Setting	Value
Name	mcp-image-metadata
Region	Oregon
Build Command	`npm install && npm run build`
Start Command	`node dist/index.js`

Add Environment Variables (see above)
Deploy

Local Development

# Install dependencies
npm install

# Build
npm run build

# Run (stdio mode)
npm run dev

# Run with HTTP server
PORT=3000 node dist/index.js

Supported Image Formats

JPEG/JPG
PNG
GIF
WebP
TIFF
HEIC
BMP
SVG

Tech Stack

Node.js 20+
TypeScript
@modelcontextprotocol/sdk
Sharp (image processing)
ExifReader (metadata parsing)
Express (HTTP server)
Multer (file uploads)

MCP Image Metadata MCP Server

About

Security Report

Findings (14)Action required

Permissions Required

What You'll Need

How to Install & Connect

Getting Started

Documentation

MCP Image Metadata Server

Live Demo

Quick Start

1. Upload Image

2. Extract Metadata

API Endpoints

MCP Tools

1. extract_image_metadata

2. extract_batch_metadata

3. detect_image_manipulation

4. get_pricing

Complete Usage Flow

Step 1: Upload Image

Step 2: Extract Metadata

Step 3: Get Updated Freemium Status

Pricing

Freemium

x402 Payment Integration

For Agents/Apps

Payment Flow

Environment Variables

Deployment

Render (Recommended)

Local Development

Supported Image Formats

Tech Stack

License

Reviews

No reviews yet

More Content & Media MCP Servers

MarkItDown

Toleno

mcp-creator-python

MCP Image Metadata MCP Server

About

Security Report

Findings (14)Action required

Permissions Required

What You'll Need

How to Install & Connect

Getting Started

Documentation

MCP Image Metadata Server

Live Demo

Quick Start

1. Upload Image

2. Extract Metadata

API Endpoints

MCP Tools

1. extract_image_metadata

2. extract_batch_metadata

3. detect_image_manipulation

4. get_pricing

Complete Usage Flow

Step 1: Upload Image

Step 2: Extract Metadata

Step 3: Get Updated Freemium Status

Pricing

Freemium

x402 Payment Integration

For Agents/Apps

Payment Flow

Environment Variables

Deployment

Render (Recommended)

Local Development

Supported Image Formats

Tech Stack

License

Reviews

No reviews yet