# Nubarium MCP

> Nubarium gives your AI agent access to Mexican corporate and identity data. It lets you validate RFC (tax ID), CURP (identity ID), and search for companies directly in natural conversation. You can audit legal representatives, check company status, and verify complex national records without touching a manual government portal.

## Overview
- **Category:** data-management
- **Price:** Free
- **Tags:** identity-verification, corporate-data, tax-id-validation, mexico-compliance, legal-data

## Description

Nubarium gives your AI agent direct access to Mexican corporate records and national identity data. When you connect this server, your agent runs deep due diligence against authoritative Mexican sources without needing a manual portal login. It's built for risk managers and compliance teams who need hard facts fast.

**Validating Personal Identity Records**
You can confirm if a person’s CURP is active and pull associated personal metadata using `validate_mex_curp`. This tool retrieves details like names or birth locations linked to the identifier. To check tax status, you use `validate_mex_rfc`, which verifies both individual and business RFC numbers and returns comprehensive, up-to-date tax profiles for that entity.

**Researching Corporate Entities**
You can start by querying the directory with `search_mex_companies` to pull a list of potential Mexican businesses based solely on a name string. Once you have an ID, you get all available details—a full corporate dossier—by calling `get_mex_company_details`. This provides a complete view of the company’s status and history.

**Verifying Legal Links (Due Diligence)**
The most critical check is verifying legal representation. You use `validate_mex_legal_representative` to confirm if an individual is officially linked as a representative for a specific corporate entity, cross-referencing both their RFC and CURP against the company's records.

**Monitoring Usage**
For operational visibility, you can check your API consumption limits using `get_api_usage`. This reports the current usage metadata so you know exactly how much research volume your agent is generating.

It's simple: You just ask the agent questions in plain English. It handles all the function calls behind the scenes. Don't worry about complicated data structures; just give it names, IDs, and concepts, and your AI client runs the necessary checks.

## Tools

### validate_mex_curp
Confirms if a provided Mexican CURP is valid and returns associated personal details like names or birth locations.

### validate_mex_rfc
Validates a Mexican tax ID (RFC) and retrieves comprehensive, up-to-date tax profile information.

### get_mex_company_details
Pulls a full, detailed record for a Mexican company using its unique identification number.

### get_api_usage
Retrieves metadata showing the current usage and consumption limits for your Nubarium API key.

### search_mex_companies
Searches the directory for multiple Mexican companies based only on a name string input.

### validate_mex_legal_representative
Checks the official records to confirm an individual's legal representative status for both their RFC and CURP against a company.

## Prompt Examples

**Prompt:** 
```
Validate the Mexican RFC 'ABC123456XYZ' using Nubarium.
```

**Response:** 
```
RFC validated! The tax ID is active and associated with a registered entity in Mexico. Would you like to see the associated address or tax regime metadata?
```

**Prompt:** 
```
Check the Mexican CURP for 'John Doe'.
```

**Response:** 
```
I've retrieved the CURP details! The ID is valid and corresponds to the provided name. It identifies a birth record in Mexico City. Would you like the full identity metadata?
```

**Prompt:** 
```
Find companies in Mexico with name 'Soluciones Tech'.
```

**Response:** 
```
I've identified several companies named Soluciones Tech. Notable entries include entities in Guadalajara and Monterrey. Would you like the ID for any specific match to retrieve full dossiers?
```

## Capabilities

### Validate personal identity records
Confirms a Mexican CURP ID is active and pulls detailed personal metadata linked to that identifier.

### Audit corporate tax registration
Checks the status of any RFC (Tax ID) for both individuals and businesses, returning comprehensive tax profiles.

### Search Mexican companies by name
Queries the database to find multiple matching Mexican company records using a simple name search.

### Get full corporate dossiers
Retrieves all available details for a specific Mexican company ID, providing a complete view of its status and history.

### Verify legal representation links
Checks the official link between an individual (CURP/RFC) and a corporate entity to confirm representative status for due diligence.

### Monitor server usage
Reports current API call metadata, letting you track how much research volume your agent is generating.

## Use Cases

### Onboarding a new partner in Mexico
The risk manager needs to onboard 'Acme Corp.' They first run `search_mex_companies` by name. Once they get the ID, they use `get_mex_company_details`. Finally, they verify the primary signatory using `validate_mex_legal_representative`, ensuring all compliance checks pass before signing a contract.

### Auditing a suspect tax profile
A data analyst suspects an individual's tax status. They start by running `validate_mex_rfc` with the known ID. This confirms if the RFC is active and retrieves the full tax regime metadata, solving the problem of incomplete public records.

### Verifying a client's personal identity
A compliance officer gets a new lead. They use `validate_mex_curp` with the provided ID and name. The tool validates the CURP and returns detailed birth information, instantly confirming if the person is who they claim to be.

### Due diligence on an unknown entity
A user needs to know everything about 'Soluciones Tech'. They run `search_mex_companies` to get a list of potential matches, then pick the most likely ID and execute `get_mex_company_details`. This gives them a full corporate picture in one sequence.

## Benefits

- **Complete Compliance Checks:** Use `validate_mex_curp` and `validate_mex_rfc` to instantly audit identity IDs. You get confirmation that the data is accurate, saving days of manual portal work.
- **Deep Corporate Dossiers:** Don't just get a name match. Run `get_mex_company_details` after using `search_mex_companies` to pull an entire corporate history for due diligence.
- **Confirm Legal Status:** Use `validate_mex_legal_representative` to prove who runs the company. This is crucial; you verify the link between a person and the entity, not just their IDs.
- **Speed Over Manual Portals:** Your agent handles all the complex lookup logic. You don't open six different government websites—you ask one question in chat.
- **Track Usage Effortlessly:** Run `get_api_usage` to monitor your research volume and keep strict control over API consumption, which is vital for large-scale data analysis.

## How It Works

The bottom line is you get validated Mexican data directly in chat, without leaving your AI client.

1. Subscribe to the Nubarium MCP Server and input your unique API key.
2. Connect your preferred AI client (Claude, Cursor, etc.) to the server via the MCP protocol.
3. Instruct your agent with natural language queries (e.g., 'Validate this RFC'). The agent executes the necessary tool calls using the stored credentials.

## Frequently Asked Questions

**How do I validate a person's identity using validate_mex_curp?**
You provide the CURP ID and the agent validates it against records. It confirms if the ID is active and returns associated personal metadata, like names or birth locations.

**Which tool should I use to check a company's tax status?**
Use `validate_mex_rfc`. This checks the RFC (Tax ID) for both individuals and businesses, providing comprehensive and current tax profile data.

**Can I only search companies by name using search_mex_companies?**
Yes. The `search_mex_companies` tool takes a name string as input to locate potential matches across the directory, which you then refine with `get_mex_company_details`.

**How does validate_mex_legal_representative work?**
This tool verifies the formal link between an individual (using CURP/RFC) and a corporate entity. It confirms if that person is officially recognized as a legal representative for the business.

**Is there a way to track my API usage with Nubarium?**
Yes, you use `get_api_usage`. This tool pulls metadata showing your current quota and consumption limits, helping you manage large-scale data queries.

**What's the proper workflow when I first use `search_mex_companies` to find a record?**
You must run `search_mex_companies` before getting details. The search returns potential matches, and you then need the specific company ID to pass into `get_mex_company_details`. This ensures you pull the correct dossier for that entity.

**If I use `validate_mex_rfc` and receive an error message, does it mean the tax ID is fake?**
It means the system could not find a match or the ID isn't active. The specific error code tells you if the issue is invalid formatting or simply that no record exists for that RFC.

**When I call `validate_mex_curp`, what kind of personal data do I get back besides validation status?**
You receive comprehensive identity metadata. This includes the name associated with the ID, birth date, and location details for the record found in Mexico.

**How do I find my Nubarium API Key?**
Log in to your [**Nubarium dashboard**](https://nubarium.com/), and you will find your API Key under the 'API Settings' or 'My Keys' section. Copy and paste it below.

**Can the agent validate Mexican tax IDs (RFC)?**
Yes. Use the `validate_mex_rfc` tool providing the RFC string. Your agent will verify its status with official sources instantly.

**Is CURP validation supported for individuals?**
Yes. The `validate_mex_curp` tool allows your agent to check the identity status of individuals in Mexico using their unique CURP ID.