# MCP tools

Canonical documentation: https://veripoint.ai/api-docs/mcp-tools

## research_company

Research a private or public company, or compare companies, using available financial records. Include legal name and country, registration number or ticker, and the financial question. Returns analysis and evidence with periods, currencies, units and scope. Missing values remain unavailable. A completed answer consumes one workspace search and is saved; a failed or clarifying answer is not a completed analysis. Check get_usage first and saved reports before retrying an interrupted search.

```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 3,
      "maxLength": 3000,
      "description": "A self-contained financial question identifying the legal entity and jurisdiction. Example: Analyse Microsoft Corporation (MSFT), United States, using available annual statements; show reporting periods, currency, scope and evidence."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}
```

## list_reports

Find saved reports in the authorized workspace. Returns at most 20 reports per page. Does not run research or consume searches.

```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional words to find in saved questions or answers."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100000,
      "description": "Page number, starting at 1."
    }
  },
  "additionalProperties": false
}
```

## get_report

Read one saved report in the authorized workspace, including source evidence and financial-statement datasets. Obtain the report ID from list_reports or a completed research_company response. Does not consume searches.

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Saved report ID. This is not a company registration number or ticker."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}
```

## get_usage

Check the authorized workspace plan, searches used and remaining, and the next reset date. Reading saved reports and checking usage do not consume searches. Free allowance resets daily at 00:00 UTC; paid allowances reset monthly.

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

Tool catalogue: https://veripoint.ai/mcp-tools.json

Inspect MCP isError. Never treat a failed or incomplete research response as a completed answer.