Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "idphoto": {
      "type": "http",
      "url": "https://mcp.idphoto.ai/mcp",
      "headers": {
        "X-IDP-API-Key": "${X_IDP_API_KEY}",
        "X-IDP-API-Secret": "${X_IDP_API_SECRET}"
      }
    }
  }
}

claude mcp add --transport http idphoto https://mcp.idphoto.ai/mcp --header "X-IDP-API-Key: ${X_IDP_API_KEY}" --header "X-IDP-API-Secret: ${X_IDP_API_SECRET}"

[mcp_servers.idphoto]
url = "https://mcp.idphoto.ai/mcp"
env_http_headers = { "X-IDP-API-Key" = "X_IDP_API_KEY", "X-IDP-API-Secret" = "X_IDP_API_SECRET" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "idphoto": {
      "type": "remote",
      "url": "https://mcp.idphoto.ai/mcp",
      "enabled": true,
      "headers": {
        "X-IDP-API-Key": "{env:X_IDP_API_KEY}",
        "X-IDP-API-Secret": "{env:X_IDP_API_SECRET}"
      }
    }
  }
}

{
  "mcpServers": {
    "idphoto": {
      "type": "http",
      "url": "https://mcp.idphoto.ai/mcp",
      "headers": {
        "X-IDP-API-Key": "${X_IDP_API_KEY}",
        "X-IDP-API-Secret": "${X_IDP_API_SECRET}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=idphoto&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLmlkcGhvdG8uYWkvbWNwIiwiaGVhZGVycyI6eyJYLUlEUC1BUEktS2V5IjoiJHtYX0lEUF9BUElfS0VZfSIsIlgtSURQLUFQSS1TZWNyZXQiOiIke1hfSURQX0FQSV9TRUNSRVR9In19"
}

{
  "servers": {
    "idphoto": {
      "type": "http",
      "url": "https://mcp.idphoto.ai/mcp",
      "headers": {
        "X-IDP-API-Key": "${X_IDP_API_KEY}",
        "X-IDP-API-Secret": "${X_IDP_API_SECRET}"
      }
    }
  }
}

{
  "mcpServers": {
    "idphoto": {
      "httpUrl": "https://mcp.idphoto.ai/mcp",
      "headers": {
        "X-IDP-API-Key": "${X_IDP_API_KEY}",
        "X-IDP-API-Secret": "${X_IDP_API_SECRET}"
      }
    }
  }
}

extensions:
  "idphoto":
    enabled: true
    name: "idphoto"
    type: streamable_http
    uri: "https://mcp.idphoto.ai/mcp"
    headers:
      "X-IDP-API-Key": "${X_IDP_API_KEY}"
      "X-IDP-API-Secret": "${X_IDP_API_SECRET}"
    timeout: 300

Placeholders to fill from your own secret store: ${X_IDP_API_KEY}, ${X_IDP_API_SECRET}. The registry never accepts secret values.

Quality 85 / 100new

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene93 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations4 of 4 tools declare readOnlyHint or destructiveHint
warn
tools.directory_hints1 of 4 tools declare all four hints; missing: get_photo_spec (destructiveHint, idempotentHint); get_usage (destructiveHint, idempotentHint); list_photo_specs (destructiveHint, idempotentHint)
pass
tools.token_costabout 540 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool history recorded for 1 of the 7 days needed

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

4 tools, about 540 tokens to load them all · tool set 97d26ddc75a1 · tools last changed 2026-10-20 · checked 2026-10-20 17:02 UTC

Tool changes

2026-10-20make_id_photochangedinput schema

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 83 / 100

no-repository

provenance55

liveness100

freshness100

hygiene80

+dns-namespace +website +reachable +uptime-100% +updated-1d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://mcp.idphoto.ai/mcp` streamable-http	none	yes	100%	191 ms	2025-11-25	2026-10-20

Tools (4)

`get_photo_spec`read-only	Get the detailed requirements of one photo spec: physical size, pixel size, DPI, background color, head height / eye position guidance, glasses and expression rules.
`get_usage`read-only	Show remaining quota. With API credentials: the idphoto.ai account status and remaining make-photo quota. Without credentials: how many free make_id_photo calls are left today.
`list_photo_specs`read-only	List all supported passport / visa / ID photo specifications as specCode + human-readable name (e.g. 'us-passport' = 'US Passport'). Use this to find the specCode for make_id_photo.
`make_id_photo`	Turn a portrait photo into a compliant passport / visa / ID photo for a given document spec (cropping, resizing, background replacement, quality checks). Returns a temporary download URL for the finished JPEG, its pixel/physical size, and any detected quality issues (e.g. ISSUE_EYEGLASSES_NOT_ALLOWED) that may require a retake. Use list_photo_specs or get_photo_spec first if you are unsure of the specCode. The input image must be base64 (data URI prefix allowed), at most ~4 MB decoded, showing one person facing the camera. Without API credentials this is limited to 3 photos per day.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "ai.idphoto/mcp",
  "title": "IDPhoto.ai Passport & Visa Photos",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.idphoto.ai/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "X-IDP-API-Key",
          "isSecret": true,
          "description": "idphoto.ai API key (optional; without it make_id_photo is limited to 3 free photos per day)"
        },
        {
          "name": "X-IDP-API-Secret",
          "isSecret": true,
          "description": "idphoto.ai API secret (required together with X-IDP-API-Key)"
        }
      ]
    }
  ],
  "version": "0.1.0",
  "websiteUrl": "https://idphoto.ai",
  "description": "Turn a portrait into a compliant passport, visa or ID photo. 300+ official specs, 3 free a day."
}