# OpenCorporates MCP

> OpenCorporates MCP provides direct access to one of the world's largest open databases of company records and global corporate officers. Use your AI agent to perform deep due diligence, running complex audits by searching across hundreds of jurisdictions instantly. It lets you audit business registrations and track ownership structures without manually filling out forms or browsing regional government websites.

## Overview
- **Category:** business-intelligence
- **Price:** Free
- **Tags:** corporate-records, due-diligence, kyc, entity-lookup, business-registry, audit

## Description

OpenCorporates connects your agent directly to a massive database of company information worldwide. This MCP turns tedious corporate research into simple conversation. Instead of needing to visit dozens of national registries, your AI client searches across global jurisdictions to find specific companies and their directors. You can ask it to audit an entire corporate structure or track down the history of an officer associated with multiple entities. It gathers detailed metadata—like official registration numbers and current status—allowing you to build a complete picture of ownership groups instantly. If you're running competitive analysis or just doing general background checks, your agent acts like a real-time investigator, grounding all your business intelligence in verified data. It’s the kind of resource that makes Vinkius such a valuable catalog for professional research.

## Tools

### get_company_details
Fetches all information for a specific company using its jurisdiction and registration number.

### get_corporate_grouping
Retrieves detailed records showing the complex relationships within corporate ownership groups.

### get_api_status
Checks your current API token usage and overall account metadata limits.

### list_jurisdictions
Provides a complete list of all countries or regions supported by the database.

### search_companies
Searches for potential companies using keywords or general names across global locations.

### search_officers
Finds and lists corporate officers and directors associated with specific entities.

## Prompt Examples

**Prompt:** 
```
Search for companies named 'Vinkius' using OpenCorporates.
```

**Response:** 
```
I've retrieved several companies named Vinkius. Notable matches include entities in Brazil and Europe. Would you like the full registration metadata for any specific jurisdiction?
```

**Prompt:** 
```
Show company details for 'google' in jurisdiction 'us_de' (Delaware).
```

**Response:** 
```
I've identified Google in Delaware. The company number is 2838522. I can retrieve the full list of officers and corporate groupings for this entity if you'd like.
```

**Prompt:** 
```
Find corporate officers named 'John Smith'.
```

**Response:** 
```
I've identified several officers named John Smith across various jurisdictions. Notable roles include directors in tech and finance sectors. Would you like the company details for any specific match?
```

## Capabilities

### Search Global Companies
Find company records by name or keyword across multiple international jurisdictions.

### Identify Corporate Officers
Locate and audit the history of directors and corporate officers tied to specific entities.

### Map Ownership Structures
Get details on complex corporate groupings to understand who owns what, instantly.

### Check Jurisdictional Reach
List and query all supported countries and jurisdictions in the database.

### Verify API Usage
Monitor your research volume by checking the current usage status of your access token.

## Use Cases

### Verifying a Target Company's Status
A client needs to vet an investment target in France and Brazil. Instead of checking two separate national registries, they ask their agent to search_companies for the entity across both jurisdictions. The agent returns the full metadata using get_company_details, giving them instant verification.

### Tracing Hidden Ownership Chains
A journalist suspects a major corporation is controlled by multiple smaller shell companies. They use search_companies to find the initial entity, then prompt the agent with get_corporate_grouping to map out all related owners and subsidiaries.

### Background Check on an Executive
A legal team needs to confirm if a key executive has worked for any other companies in the tech sector. They run search_officers, quickly identifying every director named John Smith across multiple jurisdictions and getting their associated company details.

### Pre-Acquisition Due Diligence
An M&A team needs to know if a target's directors have any overlapping interests. They use get_corporate_grouping on the main entity, which instantly highlights all shared ownership links and related parties.

## Benefits

- Quickly determine a company's existence and status. Instead of navigating complex national websites, use the search_companies tool to find records across hundreds of jurisdictions with a single prompt.
- Track ownership structures instantly. The get_corporate_grouping tool reveals complex relationships between entities, eliminating days of manual chart drawing and cross-referencing.
- Audit key personnel history. Use search_officers to build comprehensive profiles of directors, seeing their roles across multiple companies without lifting a finger.
- Maintain control over your research volume. The get_api_status tool lets you monitor usage in real time, so you never hit an unexpected rate limit mid-audit.
- Understand global scope immediately. Run list_jurisdictions to know exactly which countries are covered before starting any investigation.

## How It Works

The bottom line is you get verified corporate intelligence delivered directly into your workflow using natural language prompts.

1. Subscribe to this MCP and provide your OpenCorporates API Token in Vinkius.
2. Connect this MCP via any compatible client, like Claude or Cursor.
3. Ask your agent a question, such as 'Find all companies related to XYZ in Germany.' The agent executes the necessary lookups and returns structured data.

## Frequently Asked Questions

**How does OpenCorporates MCP find company details?**
It connects to an open, global database that aggregates official records from hundreds of jurisdictions. You can use get_company_details with a specific jurisdiction and number.

**Can I find officers for companies not in the US?**
Yes. OpenCorporates supports multiple international jurisdictions. Start by running list_jurisdictions to see which countries are covered before searching for directors using search_officers.

**What is a corporate grouping and how do I use it?**
A corporate grouping reveals complex ownership structures—the web of parent/subsidiary companies. Use the get_corporate_grouping tool to map these relationships instantly.

**Is OpenCorporates MCP for real-time market pricing?**
No, this MCP is strictly for corporate records and legal entity data. It cannot provide live stock prices or financial statements; its focus is on verified organizational structure.

**What if I don't know the company number?**
You can still start by using search_companies with a name or keyword. The initial results will give you jurisdictional options, and then you can get the full details using get_company_details.