MCP Server Guide
Connect AI agents directly to the Singula API using the MCP protocol.
What is MCP?
The Model Context Protocol (MCP) is an open standard that allows AI agents to connect with external tools and data. Singula's MCP server exposes all our verification tools as tools that any compatible agent can use.
Installation
Install the Singula MCP server with npm:
npm install -g @anthropic-ai/singula-mcp-serverConfiguration
Add the configuration to your MCP client (Claude Desktop, Cursor, etc.):
{
"mcpServers": {
"singula": {
"command": "npx",
"args": ["-y", "@anthropic-ai/singula-mcp-server"],
"env": {
"SINGULA_API_KEY": "sk_live_..."
}
}
}
}Replace sk_live_... with your real API key from the Singula dashboard.
Available Tools
The MCP server exposes the following tools that your AI agent can use:
createCustomer
Create physical person with personal data
createMoralCustomer
Create moral person (company)
getCustomer
Complete customer detail
getCurp
Get customer CURP
validateCurp
Validate CURP against RENAPO
getRfc
Get customer RFC
validateRfc
Validate RFC against SAT
getNss
Get NSS from IMSS
checkBlacklist
Search sanctions lists (OFAC, EU, UN, UK)
getJudicialRecords
Judicial records for physical person
getJudicialRecordsMoral
Judicial records for moral person
getIntelligence
OSINT investigation: social, news, records
createVerification
Create KYC verification link (ID + selfie)
searchCustomers
Search customers by name or ID
listCustomers
List all customers paginated
emailLookup
Verify email address
phoneLookup
Verify phone number
Usage Examples
Once configured, your AI agent can use the tools directly:
Full identity verification
"Create a customer with this data and validate their CURP against RENAPO"
Background check
"Search the judicial records and blacklist for this customer"
Automated due diligence
"Run a full OSINT investigation on customer cus_abc123"
Compatible Clients
Singula's MCP server works with any client that supports the protocol:
Claude Desktop
Official Anthropic app
Cursor
AI-powered IDE
Claude Code
Claude CLI for development
Windsurf
IDE with AI agents
Cline
VS Code extension with MCP