# Cora Bank MCP MCP

> Cora Bank MCP connects your corporate account to your agent. It lets you generate formal invoices with Brazilian Boleto and Pix codes, check current balances, track transaction history, and send payments directly from chat.

## Overview
- **Category:** finance-accounting
- **Price:** Free
- **Tags:** corporate-banking, invoicing, pix-payments, boleto, financial-api, cash-flow-management

## Description

This connection attaches your company's financial data right into your AI client or conversational agent. You can draft detailed invoices that include both a standard Boleto barcode and a Pix QR code for maximum payment options. Need to pay a vendor? Just sending a message clears out those daily transactions without opening any banking app. It also lets you pull full accounting statements, check current balances, and cancel old bills when things change. Integrating this financial data into your workflow through Vinkius makes sure that all these capabilities are available from one place.

## Tools

### cora_cancel_invoice
Cancels a pending invoice within Cora Bank.

### cora_create_invoice
Creates an official invoice, including both the Boleto bank code and Pix QR Code.

### cora_get_balance
Retrieves all current funds, showing total balances held or pending in Cora Bank.

### cora_get_invoice
Consults the detailed status and data for a specific invoice.

### cora_get_statement
Extracts the full accounting history, including receipts and cash flow statements.

### cora_list_invoices
Generates a mass list of invoices and confirms their current processing status.

### cora_list_payments
Retrieves an array containing the withdrawals made from your account or base.

### cora_send_pix
Sends a TED or Pix payment to either a vendor or a client.

## Prompt Examples

**Prompt:** 
```
Draw up a Cora Invoice for client Gabriel (CPF 908129841). Bill them exactly R$ 150 BRL for the 'Graphic Design Package' with due date at the end of next month.
```

**Response:** 
```
Success. Cora Bank has recognized and generated a formal Invoice. Tracking ID matched. You can supply them with the associated barcode string outputted logically above right now.
```

**Prompt:** 
```
Fetch the final Cora Account statement focusing from 2024-04-01 until 2024-04-06 to ensure we captured all vendor payouts.
```

**Response:** 
```
Evaluating API responses constraint: Statement arrays captured exactly 14 operational days log events within that interval. Specifically indicating three substantial outward vendor Pix paths totaling X ammount.
```

**Prompt:** 
```
Cancel the Cora pending invoice reference 'INV_17009401' completely. We negotiated an upfront cash structure.
```

**Response:** 
```
Signal passed downwards to cancelation logic. The identified Cora invoice array has been purged and set to 'DELETED_OR_CANCELED'. Barcodes will bounce if the user attempts scanning them.
```

## Capabilities

### Generate Official Invoices
Create a detailed digital invoice that automatically includes both Boleto and Pix payment codes.

### Manage Payments
Send TED or Pix payments to vendors or clients directly through your agent's text interface.

### Check Account Status
Retrieve all current available funds, including any balances that are held or pending.

### Review Financial History
Extract full accounting history, cash flow records, and statements for auditing.

### View Billing Details
Get the status or specific data points of any existing invoice.

### List Pending Bills
Pull a mass list of invoices and track their current processing status.

## Use Cases

### Client payment confirmation is needed immediately
A freelance designer asks their agent: 'Did Gabriel pay the invoice for the graphic package?' The agent runs `cora_get_invoice` to confirm status and then uses that data to draft a follow-up message.

### End of month reconciliation
The ops manager asks: 'Get me the statement for April 1st through April 6th, focusing on vendor payouts.' The agent executes `cora_get_statement` to pull the necessary historical data.

### Urgent payment needed
You need to pay a critical supplier right now. Instead of opening your banking app, you tell your agent to run `cora_send_pix`, specifying the recipient and amount.

### Overdue invoice needs modification
A client's billing details changed. The ops manager uses `cora_list_invoices` to find the ID, then runs `cora_cancel_invoice` before generating a corrected bill.

## Benefits

- Instead of logging into a separate banking app to pay vendors, you can send payments instantly using the `cora_send_pix` tool directly through your chat agent.
- You eliminate manual document creation; use `cora_create_invoice` to generate detailed bills that include both Boleto and Pix codes in one step.
- Get a full picture of cash flow by calling `cora_get_statement`, which pulls the complete accounting history, not just today's transactions.
- Need to know if an invoice was paid? Use `cora_list_invoices` for mass status checks or `cora_get_invoice` for a deep dive on one specific bill.
- Track your money before spending it. `cora_get_balance` provides immediate visibility into all pending and held funds, letting you plan payments accurately.

## How It Works

The bottom line is that you're bridging the bank account data safely by passing encrypted credentials through your Vinkius app.

1. You first use your admin panel to define the API target within Cora.
2. The system issues unique Private key and Application certificate files, which you encode into two string payloads using a terminal command.
3. Save these encoded strings inside your Vinkius application to establish secure access.

## Frequently Asked Questions

**How do I encode my Cora `.pem` certificates properly?**
Head to Cora Bank's portal and setup an API App yielding you exactly the Client Credentials and a certificate pairing (Public CERT `.pem`/`.crt` and Private `.key`). Go to a UNIX shell / MacOS Terminal: `base64 -i my_key.key` to get the key text, and `base64 -i my_cert.pem` to get the cert text. The unformatted, unbroken blocks are the credentials you paste directly to us.

**Does Cora produce a separate Pix link from its Boleto command?**
In Cora's domain, executing `cora_create_invoice` natively packages everything. A single entity 'Invoice' acts as both your printable boleto format AND a highly specific Dynamic QR Pix, ensuring multiple avenues for your clients.

**Will an outgoing Pix from my chat be instant?**
Absolutely. Emitting an explicit request down the `cora_send_pix` route connects instantaneously down Cora's active routing engine (Sistema de Pagamentos Instantâneos - SPI/Bacen) draining specific liquidity.

**Can I cancel unpaid user invoices rapidly from MCP?**
Of course! Call upon the unneeded identifier within your chat interface, prompting the logic `cora_cancel_invoice`, pulling the document from global banking registration.

**What does `cora_get_statement` return regarding my cash flow history?**
It extracts a full accounting log spanning specific date ranges. The data provides detailed records of all receipts, payments, and movements through your corporate account.

**If I use `cora_get_invoice` on a payment that failed, what status code should I look for?**
The tool returns the current state, allowing you to check if an invoice is marked as 'FAILED' or 'PENDING'. This helps your agent determine why payments didn't clear.

**How do I retrieve a record of all past vendor payouts using `cora_list_payments`?**
This tool provides a structured array listing every withdrawal or payout executed from the account. You can process this data to reconcile previous transactions.

**What does running `cora_get_balance` show me about my immediate available funds?**
It pulls your total current balance, including both liquid cash and any pending funds. This gives you an accurate snapshot of the capital available right now.