Skip to content
MCP server

MCP

Phototology photo registry: analyze an image once, then look it up free

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally
Version
2.0.0
Listing updated
2 days ago

About MCP

MCP is a freemium MCP server for design and media. It runs locally on your machine and is started by your AI client.

Phototology turns a photograph into typed, schema-validated data through composable lenses, such as description, dating and location. This package is its stdio MCP server. Each image is keyed by SHA-256 and perceptual hash, so the first call bills one credit per lens and repeat calls on the same photo return cached results free, including near-duplicates.

The README lists seven tools, among them analyze_photo, enrich_photo, which writes results back into EXIF, IPTC and XMP, and purchase_credits, which only returns a wallet link because checkout needs a browser. It states plainly what it will not do: no identity recognition, no live video, no C2PA signing yet, no remote endpoint and no local model, so an API key and network access are required.

Set PHOTOTOLOGY_API_KEY and optionally PHOTOTOLOGY_MCP_ALLOWED_DIRS to confine which folders it may read. Telemetry can be disabled with DO_NOT_TRACK.

Install

Run in a terminal

claude mcp add mcp --env PHOTOTOLOGY_API_KEY='<PHOTOTOLOGY_API_KEY>' -- npx -y @phototology/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@phototology/mcp"
      ],
      "env": {
        "PHOTOTOLOGY_API_KEY": "<PHOTOTOLOGY_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@phototology/mcp"
      ],
      "env": {
        "PHOTOTOLOGY_API_KEY": "<PHOTOTOLOGY_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@phototology/mcp"
      ],
      "env": {
        "PHOTOTOLOGY_API_KEY": "<PHOTOTOLOGY_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@phototology/mcp"
      ],
      "env": {
        "PHOTOTOLOGY_API_KEY": "<PHOTOTOLOGY_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@phototology/mcp"
      ],
      "env": {
        "PHOTOTOLOGY_API_KEY": "<PHOTOTOLOGY_API_KEY>"
      }
    }
  }
}

Configuration

  • PHOTOTOLOGY_API_KEYYour Phototology API key (pt_live_... for production, pt_test_... for the free fixture sandbox). Get one at https://phototology.com/dashboard. New accounts include 1,000 free credits on email verification.Required
  • PHOTOTOLOGY_BASE_URLOverride the API base URL. Defaults to https://api.phototology.com. Used for local development against phototology-api.
  • PHOTOTOLOGY_MCP_NO_TELEMETRYSet to 1 to disable anonymous telemetry: the editor name and version, the package version, and per tool call the tool name, success, duration, error code and counts. Never image content, file paths, tool inputs or outputs, or conversation text.
  • DO_NOT_TRACKSet to 1 to disable telemetry. Same effect as PHOTOTOLOGY_MCP_NO_TELEMETRY; follows the cross-tool convention many CLIs honor.
  • PHOTOTOLOGY_MCP_ALLOWED_DIRSFolders the server may read photos from and write enriched copies to, separated by : (; on Windows). Unset means any local path. Paths are checked after symlinks are resolved.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

analyze_photo
Runs AI vision on one image and returns structured facts per lens.
enrich_photo
Writes enriched metadata into the photo's EXIF, IPTC and XMP.
purchase_credits
Returns a wallet link for buying credits.

What it does

Lens-based analysis
Structured fields per lens instead of freeform prose.
Perceptual-hash cache
Repeat lookups of a photo are free.
Metadata write-back
Writes results into EXIF, IPTC and XMP.
Disclosed credit costs
Every tool and lens states its cost up front.
Folder allow list
Limit which directories the server may read.
No identity matching
Describes people without naming them.

Good for

  • Date and locate scanned family photos
  • Assess damage from roof photos in a claim
  • Extract structured fields from a photo archive
  • Avoid paying a vision model twice for the same image

Pricing

Freemium

1,000 free credits, then $0.01 per credit with no subscription

Prices change. Check phototology.com before you buy.

MCP FAQ

How much does it cost?

$0.01 per credit with 1,000 free credits on email verification.

Is a second analysis charged?

Repeat lookups of a previously analyzed photo are free; only un-cached lenses bill.

Does it need internet?

Yes. Every analysis calls the hosted Phototology API with an API key.

Can it identify people?

No. It reports physical observations and a head count, never a name.

Is MCP free?

MCP has a free plan, with paid plans for more usage or features.

How do I add MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp --env PHOTOTOLOGY_API_KEY='<PHOTOTOLOGY_API_KEY>' -- npx -y @phototology/mcp

What are the best alternatives to MCP?

The closest alternatives to MCP are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

Alternatives to MCP

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media