# Metamap MCP connector

The Metamap connector lets Claude, ChatGPT, Cursor and other AI clients start identity verifications, run watchlist, email, phone and government record checks, and pull verification results, all inside each person's own Metamap access with every action logged.

Source: https://elaichi.ai/connectors/metamap/

## Facts

| | |
| --- | --- |
| Application | Metamap |
| Category | BG Verification |
| AI tools | 46 |
| Authentication | App credentials |
| Needs your own OAuth app | No |
| MCP endpoint | https://api.elaichi.ai/mcp |
| Works with | Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent |
| Tools advertised by name | No. 46 tools is past the 30-tool threshold, so clients use `search_tools` and `execute_tool` |

## What you can ask once Metamap is connected

- Show verifications created this week by team.
- List watchlist hits still awaiting review.
- Summarize failed email and phone risk checks.

## Connect Metamap in Elaichi

This happens once for the organization, before any client is involved.

1. Open Connections, choose Add connection, and pick Metamap.
2. Optionally set Share with, then press Connect.
3. Paste your Metamap app credentials. Metamap authenticates the app rather than a person. One person supplies the credentials once, and everyone else works through Share with.

Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which Metamap tools are exposed, rename them, or freeze arguments before anyone points a client at it.

## Connect Metamap to Claude

Endpoint: https://api.elaichi.ai/mcp

1. Open Customize, then Connectors.
2. Press Add.
3. Name it, paste the MCP server URL, then Continue.
4. Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

## Connect Metamap to ChatGPT

Endpoint: https://api.elaichi.ai/mcp

1. Open Plugins, then press the + button.
2. Name it and paste the endpoint into Server URL.
3. Leave Authentication on OAuth, then tick the risk acknowledgement.
4. Press Create, then sign in and approve.

Works on the web today. The plugin directory lives at chatgpt.com/plugins.

## Connect Metamap to Cursor

Endpoint: https://api.elaichi.ai/mcp

1. Open `~/.cursor/mcp.json`.
2. Add the endpoint under `mcpServers`.
3. Reload Cursor, then sign in and approve.

Set up per machine, so repeat it on each computer you work from.

## Connect Metamap to any MCP client

Endpoint: https://api.elaichi.ai/mcp

1. Add the endpoint as a remote MCP server.
2. Sign in and approve.

The Elaichi Agent already has these tools, with nothing to set up.

## What the consent screen decides

Only Read is granted by default, which is not enough to call a Metamap tool. Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Grant Read and Run tools. Think hard before granting Delete, which reaches into connected apps and cannot be undone.

## What teams do with Metamap through Elaichi

### Screen a new customer against watchlists

Compliance. Ask for a sanctions and adverse media screen on an applicant, or check them against your own custom watchlist, and get the result back in plain language before anyone approves the account.

### Start a verification while the applicant waits

Onboarding. Kick off a new Metamap verification from a chat, add the applicant's details, and check its status a few minutes later without opening another tab.

### Check an email or phone before approving

Risk. Ask whether the email address and phone number on an application belong to the person and how risky they look, then decide whether to move forward.

### Validate a Brazilian CPF or CNPJ

Compliance. Run a CPF validation for an individual or an extended CNPJ lookup for a company in Brazil and get the government record findings summarized in one place.

### Pull the verification report for a file

Operations. Ask for the PDF download of a completed Metamap verification, along with a list of its uploaded media, when an auditor or partner requests the evidence.

### Clear a stuck verification queue

Support. Skip a verification an applicant has abandoned, update a batch of verifications at once, or look up a single one by ID when a customer asks why their check has not finished.

## Frequently asked questions

### How do I connect Metamap to Claude?

First connect Metamap inside Elaichi by entering the app credentials from your Metamap account, and Elaichi confirms the connection on the spot. Then open Claude, go to Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp as the endpoint. There is no OAuth application to register and no client ID or secret to generate, and the whole process takes a few minutes.

### Does Metamap work with ChatGPT and Cursor as well as Claude?

Yes. Once Metamap is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any other MCP client and the Elaichi Agent. You connect Metamap once and every client your team uses can reach it.

### What can an AI agent actually do with my Metamap data?

With Metamap connected, an agent can start a verification for an applicant, add their details, check on its status, list its uploaded media and pull the PDF report. It can also run screening on your behalf: sanctions and watchlist checks, email and phone ownership and risk checks, and government record lookups in Brazil, Chile, Colombia and Costa Rica. Because Metamap offers many actions, short concrete asks such as "run a phone risk check on this number" work better than long paragraphs.

### Does connecting Metamap give the AI access to every verification in my account?

No. Every request to Metamap runs as the person who signed in, so the agent can only see and do what that person can already see and do in Metamap. Elaichi can narrow that access further, for example to read-only or to specific checks, but it can never widen it beyond what Metamap itself allows that person.

### Can my team share one Metamap connection?

Yes. One person connects Metamap in Elaichi and shares the connection with a team, and nobody else ever handles the Metamap app credentials. Each teammate still signs in to Elaichi as themselves, so the audit log records exactly who started a verification or ran a watchlist check.

### Can I stop an agent from deleting or changing verifications in Metamap?

Yes. Restrictions in Elaichi work per action, so you can block deleting a Metamap verification, skipping one or updating a batch while still allowing checks and lookups. A blocked action is never shown to the AI client at all, so no prompt, however it is worded, can reach it.

### What happens to a Metamap connection when someone leaves?

Offboarding a person in Elaichi ends their access to Metamap through every client at once, whether they connected it themselves or used a shared connection. A shared Metamap connection keeps working for everyone else on the team. If you want to remove Metamap entirely, disconnecting it once in Elaichi removes it from Claude, ChatGPT, Cursor and every other client at the same time.

## All 46 Metamap tools

Every tool below is callable through https://api.elaichi.ai/mcp once Metamap is connected, subject to the toolbox it is in and the restrictions on the caller.

- **Create a Metamap verification** (Create). Create a new MetaMap verification by specifying a flow and optional metadata for internal references. Returns: id, status, metadata, steps, computed. Required: flowId. Metadata must be ≦4Kb and one level deep.
- **Get single Metamap verification by ID** (Get). Get a MetaMap verification by id, retrieving user information after document submission or verification completion. Returns: id, status, metadata, steps, computed. Required: id.
- **Delete a Metamap verification by ID** (Delete). Delete a MetaMap verification by id. Returns an empty 204 response on success. Required: id.
- **Metamap verifications skip** (Action). Skip the mandatory 10-minute wait time for uploading the back of a document during a MetaMap verification, allowing the verification process to proceed with only the document front. Returns: success. Required: verification_id.
- **Metamap verifications bulk update** (Update). Update a user's verification status in MetaMap. Returns the updated verification object including its id and status. Required: id, status.
- **List all Metamap verification media** (List). Download MetaMap verification media (selfie images, document photos, liveness videos) for a verification using the media_auth token obtained from a Retrieve Webhook Resource Data response. Returns the verification media content (content-type-specific binary data such as images or documents) associated with the provided media_auth. Required: media_auth. The media URL expires after 30 days.
- **Create a Metamap verification input** (Create). Upload user verification inputs (document photos, selfies, liveness videos, custom documents, bank statements) to a MetaMap identity for validation. Returns: success. Required: identity_id, inputs. Body is multipart form data; inputs must match the flow configuration order on your MetaMap Dashboard.
- **Create a Metamap verification PDF download** (Create). Download MetaMap verification results as one PDF file per verification, delivered to a specified callback URL. Returns: message. Required: request_id, verification_ids, timezone.
- **Create a Metamap comply advantage** (Create). Create a ComplyAdvantage Anti-Money Laundering watchlist screening in MetaMap to check whether a person or company is listed on watchlists from over 800 organizations worldwide. Returns the screening result including id and attributes. Required: name. callbackUrl is mandatory when monitor is set to true.
- **Create a Metamap custom watchlist** (Create). Upload a CSV file of custom watchlist entries to MetaMap for screening. Returns: success. Required: watchlistId, callbackUrl, file. The CSV file supports up to 10,000 entries with a maximum size of 10MB, and processing results are delivered asynchronously via webhook.
- **Create a Metamap email ownership check** (Create). Send a one-time password (OTP) to a user's email address to verify email ownership in MetaMap. The OTP is emailed to the recipient and verification results are delivered asynchronously to the provided callbackUrl webhook. Returns the response data for the initiated email ownership check. Required: recipient, callbackUrl.
- **Create a Metamap email risk check** (Create). Create an email risk check in MetaMap by submitting an email address for fraud and validity assessment. Results are delivered asynchronously via webhook callback. Returns: email, riskScore, valid, disposable, timed_out, deliverability, catch_all, leaked, suspect, smtp_score, overall_score, first_name, common, generic, dns_valid, honeypot, spam_trap_score, recent_abuse, fraud_score,…
- **Create a Metamap phone ownership check** (Create). Create a phone ownership OTP check in MetaMap by sending an SMS verification code to a recipient's phone number. Returns the check result including an id. The verification outcome is delivered asynchronously to the provided callback webhook URL. Required: recipient, callbackUrl, locale, senderName.
- **Create a Metamap phone risk check** (Create). Create a phone risk check in MetaMap to get a risk score for a supplied phone number. Returns the risk assessment score for the phone number. Required: recipient, callbackUrl. The score is delivered to the callback webhook URL; optional metadata must be ≤4Kb and one level deep.
- **Create a Metamap govchecks brazil cnpj extended** (Create). Validate a Brazilian CNPJ (National Registry of Legal Entities) number with MetaMap against the Brazilian Internal Revenue Service (Ministério da Fazenda). Returns: cnpj, companyName, type, status, companyPhone, companyEmail, companyAddress, shareholders. Required: cnpj, callbackUrl. A webhook URL is required to receive results.
- **Create a Metamap govchecks brazil cpf validation** (Create). Validate a Brazilian CPF (Cadastro de Pessoas Físicas) number and owner data against the Brazilian Internal Revenue Service database via MetaMap. Returns: data, error, metadata. Required: cpfNumber, fullName.
- **Create a Metamap govchecks brazil cpf light** (Create). Validate a Brazilian CPF number against the Brazilian Internal Revenue Service via MetaMap GovChecks. Returns: fullName, documentNumber, status. Required: cpf, callbackUrl. A webhook URL is required to receive the asynchronous result; only compatible with Brazilian national IDs or driver licenses.
- **Create a Metamap govchecks chile registro civil** (Create). Validate a Chilean RUN number against the Civil Registry (SRCEI) via MetaMap to confirm it exists and is currently valid. Returns: documentNumber, runNumber. Required: runNumber, callbackUrl. A webhook URL is required for asynchronous result delivery; nationality defaults to CHL.
- **Create a Metamap govchecks colombia govcheck** (Create). Create a MetaMap Colombia GovCheck verification by submitting a Cédula de Ciudadanía (national ID) document number. Returns a 202 Accepted acknowledgment; verification results are delivered asynchronously to the provided callbackUrl webhook. Required: documentNumber.
- **Create a Metamap govchecks colombia migration institute** (Create). Submit a Colombia Migration Institute (Migración Colombia) residence permit verification in MetaMap. Validates that the user's name and ID issue date match the information associated with their residence permit. Returns the verification result indicating whether the user was found in the migration records. Required: documentNumber, dateOfIssue, callbackUrl. Results are also delivered…
- **Create a Metamap govchecks colombia unified legal search** (Create). Search Colombian police records in MetaMap for a user's past or current warrants or arrest cases. Returns the search result data from the criminal records check; the outcome varies (no records found, too many results, or active legal case found). Required: fullName, callbackUrl. A webhook URL must be configured to receive the results.
- **Create a Metamap govchecks colombia rue** (Create). Validate a Colombian business's national tax ID (NIT) against the Single Business and Social Registry (RUES) in MetaMap. Returns: attributes. Required: nit, callbackUrl. A webhook URL is required to receive results.
- **Create a Metamap govchecks colombia ppt** (Create). Verify a Colombian Permiso por protección temporal (PPT) document in MetaMap by searching the Colombian PPT registry against the RUMV number, identity document number, and date of birth. Results are delivered asynchronously to the provided callback webhook. Returns: id. Required: rumv, dni, dateOfBirth, callbackUrl. Date of birth must use DD-MM-YYYY format.
- **Create a Metamap govchecks costa rica tse** (Create). Validate a Costa Rican National Identity Document (DNI) against the Supreme Electoral Court (TSE) registry in MetaMap. Returns the validation result object with country-specific attributes. Required: documentNumber, callbackUrl. A webhook URL is required to receive asynchronous validation results.
- **Create a Metamap govchecks dominican rnc** (Create). Verify a Dominican Republic taxpayer's RNC (Registro Nacional de Contribuyentes) number against the Dominican Internal Revenue Service via MetaMap. Returns: documentNumber. Required: documentNumber, callbackUrl. This API requires a webhook URL; detailed verification results are delivered asynchronously via webhook.
- **Create a Metamap govchecks ghana verify card** (Create). Verify a Ghana national card in MetaMap by submitting the personal number. Returns: placeOfIssueCode, placeOfIssue, personalNumber, regDate, expiryDate, picture, signature, nationality, placeOfBirth, dateOfBirth, gender, middleName, lastName, firstName. Required: personalNumber, callbackUrl.
- **Create a Metamap govchecks ghana verify card facematch** (Create). Verify a Ghana national ID card with face match via MetaMap GovChecks. Returns: personalNumber, documentNumber, cardValidFrom, cardValidTo, surname, forenames, nationality, birthDate, gender, birthCountry, birthDistrict, birthRegion, birthTown, addresses, contact, occupations, biometricFeed, binaries. Required: personalNumber, imageBase64, callbackUrl. Returns 202 on submission; full results are…
- **Create a Metamap govchecks kenya ipr** (Create). Validate a Kenyan national ID against the Integrated Population Registration System (IPRS) via MetaMap. Returns: documentNumber, firstName, lastName. Required: documentNumber, firstName, lastName, callbackUrl. This API requires a webhook URL to receive verification results.
- **Create a Metamap govchecks kenya br** (Create). Validate a Kenyan business registration number against the Business Registration System (BRS) in MetaMap. Accepts registration numbers for both private (PVT) and corporate (CPR) businesses; verification results are delivered asynchronously to the provided webhook URL. Returns: id. Required: registrationNumber, callbackUrl.
- **Create a Metamap govchecks mexico curp** (Create). Validate a Mexican CURP number against the National Population Registry (RENAPO) in MetaMap. Returns: curp, attributes. Required: curp, callbackUrl. Results are delivered asynchronously via the provided webhook URL.
- **Create a Metamap govchecks mexico rfc** (Create). Submit a MetaMap Mexico RFC govcheck to validate a user's CURP or RFC number against the Mexican SAT (Servicio de Administración Tributaria) database, confirming the CURP exists and its associated RFC number is eligible to pay taxes. Returns validation result data delivered asynchronously to the provided webhook URL. Required: curp, callbackUrl.
- **Create a Metamap govchecks mexico rfc status** (Create). Validate a Mexican RFC (Federal Taxpayers Registry) number against the SAT database to confirm an individual's or company's RFC number is valid and active. Results are delivered asynchronously to the provided webhook URL, including the entity type (Company/Individual), number of certificates found, and certificate status (All OK/Inactive). Required: rfc, callbackUrl.
- **Create a Metamap govchecks mexico ine** (Create). Validate a user's national ID against the Mexican National Electoral Institute (INE) database in MetaMap. Returns the validation result with identity data including firstName, lastName, and dateOfBirth. Required: documentNumber, ocrNumber.
- **Create a Metamap govchecks mexico pep** (Create). Validate a user against the Mexican Politically Exposed People (Personas Expuestas Políticamente / PEP) database in MetaMap. Returns the PEP check result data indicating whether the user is a politically exposed person, with detailed results delivered asynchronously to the configured webhook URL. The PEP database is updated monthly. Required: fullName, callbackUrl.
- **Create a Metamap govchecks nigeria nin** (Create). Verify a Nigerian user's identity through the National Identity Management Commission (NIMC) using their National Identity Number (NIN) or phone number in MetaMap. Returns: documentNumber, firstName, lastName, middleName, dateOfBirth, gender, nationality. Required: callbackUrl.
- **Create a Metamap govchecks nigeria tin** (Create). Validate a Nigerian company tax ID number (TIN) issued by the Federal Inland Revenue Service (FIRS) or Joint Tax Board (JTB) in MetaMap. Returns: companyName, FirsNumber, CacNumber, JtbNumber, taxOffice, companyPhone, companyEmail. Required: taxNumber, callbackUrl. Results are delivered asynchronously via webhook — a configured webhook URL is required.
- **Create a Metamap govchecks nigeria cac** (Create). Check a company's Corporate Affairs Commission (CAC) registration number in Nigeria. Returns: type, companyName, cacNumber, status, companyAddress, companyEmail, registrationDate. Required: registrationNumber. Supports BN (Business Name) and RC (Registered Company) entity types.
- **Create a Metamap govchecks nigeria cac affiliate** (Create). Search for company affiliates using one or more Nigeria CAC company IDs in MetaMap. Returns affiliate details including name, position, status, dateOfBirth, phoneNumber, email, city, address, idType, idNumber, shares, and accreditationNumber. Required: companyIds, callbackUrl. Results are delivered asynchronously via the webhook URL; some fields may be empty.
- **Create a Metamap govchecks panama tse** (Create). Validate a Panamanian national ID against the Supreme Electoral Court (Tribunal Supremo Electoral / TSE) registry via MetaMap GovChecks. Returns: name, documentNumber, status. Required: documentNumber, callbackURL. Results are delivered asynchronously to the callback webhook URL.
- **Create a Metamap govchecks panama tse facematch** (Create). Create a Panama TSE facematch verification in MetaMap by submitting a national ID document number and a base64-encoded selfie image for face-match validation against Panama's Electoral Court (TSE) registry. Returns the verification result data including documentNumber. Required: documentNumber, imageBase64, callbackUrl. Results are delivered asynchronously via webhook.
- **Create a Metamap govchecks paraguay rcp** (Create). Submit a Paraguay RCP govcheck verification request in MetaMap to validate a document against the Paraguayan civil registry. Returns: id, status. Required: documentNumber, callbackUrl. Verification results are delivered asynchronously to the provided callback webhook.
- **Create a Metamap govchecks peru govcheck** (Create). Validate a user's Peruvian national identity document (DNI) against the National Registry of Identification and Civil Status (RENIEC) in MetaMap. Returns: id, status. The full validation results are delivered asynchronously to the provided webhook URL. Required: documentNumber, callbackUrl.
- **Create a Metamap govchecks peru migration institute** (Create). Submit a MetaMap GovCheck against the Peru Migration Institute to validate a user's document number and ID issue date against migration records. Returns: id, documentNumber, and validation status. Required: documentNumber, dateOfIssue, callbackUrl. Results are delivered asynchronously via webhook.
- **Create a Metamap govchecks peru sunat** (Create). Verify a taxpayer's document number against Peru's SUNAT (Superintendencia Nacional de Aduanas y de Administración Tributaria) tax authority registry in MetaMap. Returns: id. Required: documentNumber, callbackUrl. Results are delivered asynchronously to the provided callback URL.
- **Create a Metamap govchecks philippines umid ssn** (Create). Create a Philippines UMID-SSN GovCheck in MetaMap to validate a user's UMID/SSN number. Returns: documentNumber. Required: documentNumber, callbackUrl. Verification results are delivered asynchronously via webhook to the callback URL.
- **Create a Metamap mexico court record** (Create). Create a Mexico court records background check (Buholegal) in MetaMap to search a user's legal records. Results are delivered asynchronously to a webhook URL. Returns: id. Required: fullName, callbackUrl.