
VerifEye
ai.realeyesPublished by realeyes.aiOfficial publisherv1.1.1Updated Oct 24, 2026
VerifEye Face API: Identify (apparent age, gender, emotions, attention), Onboard and Compare faces.
Overview
Remote Realeyes VerifEye server that lets an assistant analyze faces for apparent age, gender, emotions and attention, and onboard, compare and manage face…
- What you can do
- Analyze faces in an image for apparent age, gender, momentary emotions and attention, optionally identifying against a collection
- Onboard faces into a collection and compare a new image against one onboarded face
- List, create, describe, reset and delete collections
- Find onboarded faces by your own key, attach or remove that key, and delete a face
- Get a short-lived upload URL for submitting an image
- When to use it
- Useful when you want an assistant to run face analysis or face matching through the VerifEye Face API without writing integration code, for example estimating audience attributes from photos or checking whether a visitor is already enrolled in a collection.
- Requirements
- A remote endpoint at the documented VerifEye server URL over Streamable HTTP; no local install. A VerifEye Developer Console account and an MCP client that supports remote servers with OAuth 2.1 (authorization code with PKCE); some clients need a pre-registered client ID. Images must be given as public JPEG or PNG links, or uploaded via the upload URL tool. Each call runs in the EU unless the US region is requested.
Installation
In SourceWeft
- Open VerifEye in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/ai.realeyes%2Fverifeye/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.
{
"mcpServers": {
"verifeye": {
"type": "http",
"url": "https://verifeye-mcp-server.realeyes.ai/mcp"
}
}
}README
VerifEye MCP Server
The VerifEye MCP Server is a remotely hosted Model Context Protocol (MCP) server from Realeyes. It exposes the VerifEye Face API as tools an AI assistant can call: analyze a face for apparent age and gender plus momentary emotions and attention (Identify), onboard a face so the same person is identified later (Onboard), compare an image against one onboarded face (Compare), and manage the collections onboarded faces live in.
The server is hosted by Realeyes, so there is nothing to install or run. This repository holds its public listing metadata for MCP registries: server.json.
Full documentation: https://verifeye-docs.realeyes.ai/verifeye-apis/mcp-server/
Server URL
Transport: Streamable HTTP. This is the server's only address. If a registry or directory lists a different one, do not connect to it, and contact us.
Requirements
- A VerifEye Developer Console account.
- An MCP client that supports remote MCP servers with OAuth.
Authentication
The server uses OAuth 2.1 (authorization code with PKCE). When you connect, a VerifEye sign-in and consent screen opens in your browser. You never put an API key into your MCP client: your account's API key is resolved on the server side and is never exposed to the client.
The server offers no dynamic client registration. ChatGPT, VS Code and Codex identify themselves with a Client ID Metadata Document, so there is nothing to enter. Claude, Claude Code, Cursor and the Gemini CLI use a pre-registered client ID.
Connecting a client
Step-by-step setup for Claude Code, Claude, ChatGPT, VS Code, Cursor, the Gemini CLI and Codex, including the client ID each one needs, is in the documentation: Connecting a client.
For example, in VS Code add .vscode/mcp.json to your project root:
Start the server from the MCP: List Servers command, then sign in when the browser opens.
Using the server
Once the server is connected and you have signed in, ask in plain language and the assistant picks the tools.
Give the image as a link. The image tools take a public URL of a JPEG or PNG image, which VerifEye fetches itself. An image attached to the conversation cannot be passed to a tool, so put the image somewhere reachable and give the assistant that link. Prefer a pre-signed link that expires in minutes to a durably public URL. Where the server offers verifeye_get_upload_url and your client can make HTTPS requests of its own, the client can upload the image instead. Image requirements: documentation.
Choose the region. Every call runs in the EU (eu) unless you ask for the US (us). Collections are per region, so ask for the same region each time you work with a collection.
Example prompts
The image links are placeholders: use a link to your own image. Prompts 2 to 5 build on each other and use the collection and the face that prompt 2 creates.
Many clients ask you to approve a call before it runs, for example before a face is onboarded or deleted.
Tools
Every tool takes region (eu or us, eu by default), which selects where the image is processed and where a collection lives. Collections are per region: one created in eu is not visible from us.
Parameters, results and error codes for each tool are in the documentation.
Biometric data and consent
These tools process facial (biometric) data. You are responsible for obtaining valid, informed consent before a call runs, and for meeting the privacy and biometric-data regulations that apply to the people in your images (for example GDPR, BIPA and CCPA).
verifeye_onboard_facestores a face template that persists until it is deleted.verifeye_delete_face,verifeye_reset_collectionandverifeye_delete_collectiondestroy face templates permanently.- Age is an apparent-age estimate, not a legal proof of age. Gender is a demographic estimate, not a self-declared identity attribute. A face match is evidence of similarity, not an identity check on its own.
- Tool calls run as your VerifEye account and count against your account's usage limits.
Links
- Documentation: https://verifeye-docs.realeyes.ai/verifeye-apis/mcp-server/
- MCP Registry entry (
ai.realeyes/verifeye): https://registry.modelcontextprotocol.io/v0.1/servers/ai.realeyes%2Fverifeye/versions/latest - Privacy Policy: https://realeyes.ai/privacy-policy/
- Terms: https://realeyes.ai/terms-for-customers/
- Support: [email protected]
Source: README.md at commit 40792e5
Tools
0Version history
2- v1.1.1LatestOct 16, 2026
- v1.1.0Oct 11, 2026
Score
75% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Declare a license in the repository or the registry entry.