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 setting up the Conta Simples MCP, you need:

1. A Conta Simples account — An active user account with access to the Internet Banking
2. An MCP-compatible client — Any client that supports remote MCP over HTTP and lets you set the server URL and authentication headers (or an equivalent auth mapping)

Server URL and authentication

Point your MCP client at the Conta Simples endpoint. Sign-in uses OAuth 2.x / OpenID Connect; the fixed CLIENT_ID is the OAuth public client identifier for this MCP (not a secret). MCP clients typically group OAuth-related settings under an auth object in the server entry — that is why CLIENT_ID appears there — and forward it as the CLIENT_ID HTTP header. Use the configuration shape your client documents.

Example configuration:

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

The value above is not personal or per company — it identifies the Conta Simples MCP client in the OAuth flow. Use it as shown. Merge this block into your client’s full MCP settings file according to its documentation.

Connecting your account

On first use, the MCP server will open a browser window to the Conta Simples Internet Banking login page. Sign in with your user credentials and authorize the MCP to access your account.

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: Política Corporativa de Privacidade e Cookies (PDF).

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