MCP Server Documentation
Overview
ID Neat is available as an MCP (Model Context Protocol) server that creates spec-compliant passport, visa, and ID photos. Connect it to Claude or any MCP-compatible client, upload a portrait photo, and get back a properly formatted result — background removed, face centered and cropped, resized to exact government-required dimensions and DPI.
Supports 200+ specifications across 70+ countries, including passports, visas, and national IDs. No account required, no watermarks. Photos are processed and returned directly — nothing is stored.
Endpoint
https://api.idneat.com/mcp- Transport: Streamable HTTP
- Authentication: None required
Tools
create_id_photo
Opens the ID photo creator for a given specification. The user uploads their photo in the UI, which automatically removes the background, crops, centers, and resizes to the spec dimensions.
| Parameter | Type | Required | Description |
|---|---|---|---|
specId | string | Yes | Spec ID, e.g. us-passport, gb-passport, cn-visa |
removeBackground | boolean | No | Whether to remove and replace the background (default: true) |
backgroundColor | string | No | Background color as hex, e.g. #ffffff (default: spec requirement) |
search_photo_specs
Search for available photo specifications by country name or country code. Returns matching specs with dimensions, resolution, and background color requirements.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Country name or code, e.g. United States, CN, passport |
list_supported_countries
Lists all supported countries and their available document types. Takes no parameters. Returns a compact list grouped by country.
Setup
Claude Desktop App
- Click the + button at the bottom-left of the chat input.
- Hover over Connectors, then click Manage connectors.
- Click the + button in the top-right corner of the Connectors panel.
- Select Add custom connector.
- Enter ID Neat as the name and https://api.idneat.com/mcp as the URL.
- Click Add.
Claude on the Web
- Go to Settings > Connectors.
- Click Add custom connector at the bottom.
- Enter ID Neat as the name and https://api.idneat.com/mcp as the URL.
- Click Add.
Other MCP Clients
Any MCP-compatible client that supports Streamable HTTP transport can connect to https://api.idneat.com/mcp directly.
Example Prompts
- “Create a US passport photo for me”
- “I need a photo for a UK visa application”
- “Make a Chinese national ID photo from my selfie”
- “What countries and document types do you support?”
- “Search for Japan photo specs”
Privacy
Photos are processed in real time and immediately discarded. No images are stored, no accounts are required, and no data is retained beyond the request. See our Privacy Policy for details.
Support
For questions or issues, contact us at ....
Try ID Neat — free, instant, and private
Create Your Photo Now