English Français العربية

com.phototology/mcp

Official registry Media and design

Persistent memory for visual intelligence. A photo registry: analyze once, look up free after that.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @phototology/mcp
Claude Code 
claude mcp add com-phototology-mcp -e 'PHOTOTOLOGY_API_KEY=<your phototology_api_key>' -e 'PHOTOTOLOGY_BASE_URL=<PHOTOTOLOGY_BASE_URL>' -e 'PHOTOTOLOGY_MCP_NO_TELEMETRY=<PHOTOTOLOGY_MCP_NO_TELEMETRY>' -e 'DO_NOT_TRACK=<DO_NOT_TRACK>' -e 'PHOTOTOLOGY_MCP_ALLOWED_DIRS=<PHOTOTOLOGY_MCP_ALLOWED_DIRS>' -- npx -y @phototology/mcp@2.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "com-phototology-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@phototology/mcp@2.0.0"
            ],
            "env": {
                "PHOTOTOLOGY_API_KEY": "<your phototology_api_key>",
                "PHOTOTOLOGY_BASE_URL": "<PHOTOTOLOGY_BASE_URL>",
                "PHOTOTOLOGY_MCP_NO_TELEMETRY": "<PHOTOTOLOGY_MCP_NO_TELEMETRY>",
                "DO_NOT_TRACK": "<DO_NOT_TRACK>",
                "PHOTOTOLOGY_MCP_ALLOWED_DIRS": "<PHOTOTOLOGY_MCP_ALLOWED_DIRS>"
            }
        }
    }
}

Environment variables

  • PHOTOTOLOGY_API_KEY required secret Your 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.
  • PHOTOTOLOGY_BASE_URL Override the API base URL. Defaults to https://api.phototology.com. Used for local development against phototology-api.
  • PHOTOTOLOGY_MCP_NO_TELEMETRY Set 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_TRACK Set to 1 to disable telemetry. Same effect as PHOTOTOLOGY_MCP_NO_TELEMETRY; follows the cross-tool convention many CLIs honor.
  • PHOTOTOLOGY_MCP_ALLOWED_DIRS Folders 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.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Phototology
  2. Packages
  3. Quick start
  4. How it's built
  5. License

Phototology

Persistent memory for visual intelligence.

phototology.com · npm scope: @phototology

Phototology is a visual-intelligence platform that analyzes a photo once and remembers the result forever, keyed by perceptual hash. Re-running any analysis on the same image — by any client, on any future day — returns the cached structured result for free.

This repository is the public source for the three npm packages that surround the platform. The Phototology API itself runs as a hosted service at api.phototology.com.

Packages

PackagePurposenpm
@phototology/sdkTypeScript client SDKnpmjs.com/package/@phototology/sdk
@phototology/mcpModel Context Protocol server for Claude Code, Cursor, VS Code, and other AI coding assistantsnpmjs.com/package/@phototology/mcp
phototologyUnscoped flagship placeholder; reserves the bare name and points to the working packagesnpmjs.com/package/phototology

Each package has its own README and CHANGELOG in its directory.

Quick start

Use the MCP in Claude Code, Cursor, or VS Code (no API key needed for the test sandbox):

npx -y @phototology/mcp

For a real API key, sign up at phototology.com.

Use the SDK programmatically:

npm install @phototology/sdk
import { PhototologyClient } from '@phototology/sdk';

const client = new PhototologyClient({ apiKey: process.env.PHOTOTOLOGY_API_KEY });
const result = await client.analyze({
  imageUrl: 'https://example.com/photo.jpg',
  lenses: ['dating', 'people', 'location'],
});
console.log(result);

How it's built

This repo is a public mirror of the relevant subdirectories from a private monorepo. Source changes flow one-way: monorepo → here. Issues and pull requests on the public packages are welcomed; the maintainer will sync fixes back to the monorepo.

The monorepo uses pnpm workspaces, TypeScript, jest (MCP) / vitest (SDK has light coverage), and ships through a sync script (scripts/sync-phototology-public.sh in the private repo).

License

MIT — see LICENSE. Each package also carries its own copy of the MIT license in its directory.

Frequently asked questions

What is com.phototology/mcp?

Persistent memory for visual intelligence. A photo registry: analyze once, look up free after that.

How do I install com.phototology/mcp?

It runs on your machine. In Claude Code: claude mcp add com-phototology-mcp -e 'PHOTOTOLOGY_API_KEY=<your phototology_api_key>' -e 'PHOTOTOLOGY_BASE_URL=<PHOTOTOLOGY_BASE_URL>' -e 'PHOTOTOLOGY_MCP_NO_TELEMETRY=<PHOTOTOLOGY_MCP_NO_TELEMETRY>' -e 'DO_NOT_TRACK=<DO_NOT_TRACK>' -e 'PHOTOTOLOGY_MCP_ALLOWED_DIRS=<PHOTOTOLOGY_MCP_ALLOWED_DIRS>' -- npx -y @phototology/mcp@2.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.phototology/mcp need an API key?

Yes. It expects PHOTOTOLOGY_API_KEY, which you set in its configuration.

Is com.phototology/mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains com.phototology/mcp?

It is published by phototology-ai. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.