MCP
Phototology photo registry: analyze an image once, then look it up free
- 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/mcpAdd 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.RequiredPHOTOTOLOGY_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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Claude Code Ultimate Guide
MCP serverMCP 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

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media