Conta Simples MCP

Overview

The Conta Simples MCP server enables AI agents to interact directly with the Conta Simples platform. It exposes a curated set of tools that allow agents to query financial data, manage cards, and automate operational workflows — all through natural language conversations.

What you can do

The Conta Simples MCP enables AI-powered workflows across key financial operations:

Setup

Prerequisites

Before connecting the Conta Simples MCP, you'll need:

1. A Conta Simples account — An active user account with access to the Internet Banking.
2. An MCP-compatible client — See the supported clients below.
3. The OAuth Client ID — 72ic737n3eng9k1l3s02kbeplk.

Supported clients

Configure your client

Pick your client below and follow the steps. You only need to do this once.

claude mcp add --transport http \
  --client-id 72ic737n3eng9k1l3s02kbeplk \
  --callback-port 8080 \
  conta-simples https://mcp.contasimples.com/mcp

{
  "mcpServers": {
    "conta-simples": {
      "url": "https://mcp.contasimples.com/mcp",
      "auth": {
        "CLIENT_ID": "72ic737n3eng9k1l3s02kbeplk"
      }
    }
  }
}

{
  "mcpServers": {
    "conta-simples": {
      "url": "https://mcp.contasimples.com/mcp",
      "oauth": {
        "enabled": true,
        "clientId": "72ic737n3eng9k1l3s02kbeplk",
        "redirectUri": "http://localhost:7777/oauth/callback"
      }
    }
  }
}

Connecting your account

The first time your client connects, the Conta Simples MCP walks you through OAuth in the browser:

Troubleshooting

Available tools

The Conta Simples MCP exposes the following tools, organized by domain:

Transactions

Users

Cards & limits

Categories

Expense proofs

Example workflows

The Conta Simples MCP supports a wide range of natural language queries across financial operations. Below are three featured workflow examples followed by a full capability map organized by domain.

Monthly closing review

You: "Which expenses are still missing receipts this month?"

The agent will:

1. Call get-card-transactions___ filtered to the current month
2. Filter results for transactions with no attached proof
3. Group by user and rank by unreceipted amount

Expected response:

I found 12 transactions this month with no receipt attached, totaling R$4,870.00:

User	Transactions	Amount
Ana Lima	4	R$2,100.00
Carlos Mendes	5	R$1,620.00
Tech Team	3	R$1,150.00

Would you like me to generate upload links for each of these transactions?

Cash flow & limit forecast

You: "What is the projected spend until end of month — will I exceed the account limit?"

The agent will:

1. Call get-credit-card-limit___ to retrieve the current available limit
2. Call get-card-transactions___ for the current month's spend
3. Calculate the daily spending rate and project through end of month

Expected response:

Available card account limit: R$80,000.00 Spent so far this month: R$48,200.00 (60.3%)

At your current daily pace of R$2,230.00/day, projected spend by end of month is R$66,900.00 — leaving a buffer of R$13,100.00.

You are not at risk of exceeding the limit this month.

Expense proof upload

You: "I have an invoice here — attach it for me"

The agent will:

1. Call get-card-transactions___ to identify the most relevant unreceipted transaction
2. Call create-expense-proof___ to generate a secure signed upload URL
3. Return the URL for file upload (PDF, PNG, or JPEG)
4. Call get-expense-proof___ after upload to confirm the binding

Expected response:

I found a matching transaction: Restaurante Figueira Rubaiyat — R$340.00 on Mar 29.

A secure upload link has been created for your invoice (valid for 15 minutes):

https://upload.contasimples.com/receipts/signed/xyz789...

Upload your PDF, PNG, or JPEG to the link above. The receipt will be automatically linked to the transaction once uploaded.

Capability map

Monthly closing & control

Cash flow & credit

Card & team management

Expense proof flow

Reconciliation & accounting

Brazil-specific (tax & compliance)

Autonomous multi-tool workflows

Authentication & security

The Conta Simples MCP uses OAuth 2.0 to authenticate your personal user account:

1. On first use, a browser window opens for you to sign in to the Internet Banking
2. After authorization, the MCP server receives a scoped access token
3. Tokens are securely stored and automatically refreshed before expiration

Permissions

The tools available to the MCP server depend on the scopes you authorize during login and your user role within the company:

Rate limits

The Conta Simples MCP enforces rate limits to ensure platform stability. When limits are exceeded, the agent will receive a 429 Too Many Requests response and automatically retry with exponential backoff.

Privacy policy

The Conta Simples MCP operates under the Conta Simples privacy framework, which describes how your data is collected, used, stored, and shared when you connect your account to AI agents through this server. Read the full document here: Corporate Privacy and Cookies Policy (PDF, Portuguese).

Support

If you run into issues connecting your account or using the Conta Simples MCP, our support team is available through the following channels:

Limitations

• Financial operations (payments, transfers) are not yet available through MCP and are planned for future releases
• The MCP server processes data in real-time and does not maintain local state between sessions

Next steps