@codespar/mcp-open-finance 0.1.2 → 0.2.0

package/dist/index.js

@@ -6,11 +6,21 @@
  * - list_accounts: List customer accounts
  * - get_account_balance: Get account balance
  * - list_transactions: List account transactions
+ * - get_account_overdraft_limits: Get account overdraft limits
  * - get_consent: Get consent details
  * - create_consent: Create a new consent request
+ * - revoke_consent: Revoke an existing consent
  * - list_credit_cards: List credit card accounts
+ * - get_credit_card_bills: Get credit card bills
  * - get_credit_card_transactions: Get credit card transactions
+ * - list_loans: List loan contracts
+ * - get_loan_payments: Get loan payment schedule
+ * - list_financings: List financing contracts
  * - list_investments: List investment products
+ * - create_payment_consent: Create payment-initiation consent
+ * - create_payment: Initiate a payment
+ * - get_personal_qualifications: Get personal customer qualifications
+ * - get_business_qualifications: Get business customer qualifications
  *
  * Environment:
  *   OPEN_FINANCE_BASE_URL — Institution API base URL
@@ -37,7 +47,7 @@ async function getAccessToken() {
             grant_type: "client_credentials",
             client_id: CLIENT_ID,
             client_secret: CLIENT_SECRET,
-            scope: "openid accounts credit-cards-accounts resources consents investments",
+            scope: "openid accounts credit-cards-accounts resources consents investments loans financings customers payments",
         }),
     });
     if (!res.ok) {
@@ -65,7 +75,7 @@ async function openFinanceRequest(method, path, body) {
     }
     return res.json();
 }
-const server = new Server({ name: "mcp-open-finance", version: "0.1.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "mcp-open-finance", version: "0.2.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -109,6 +119,18 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ["consentId", "accountId"],
             },
         },
+        {
+            name: "get_account_overdraft_limits",
+            description: "Get account overdraft (limites) via Open Finance",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    consentId: { type: "string", description: "Consent ID" },
+                    accountId: { type: "string", description: "Account ID" },
+                },
+                required: ["consentId", "accountId"],
+            },
+        },
         {
             name: "get_consent",
             description: "Get consent details by ID",
@@ -138,6 +160,18 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ["permissions", "expirationDateTime"],
             },
         },
+        {
+            name: "revoke_consent",
+            description: "Revoke an existing consent (data or payment)",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    consentId: { type: "string", description: "Consent ID to revoke" },
+                    consentType: { type: "string", enum: ["data", "payment"], description: "Consent type (default: data)" },
+                },
+                required: ["consentId"],
+            },
+        },
         {
             name: "list_credit_cards",
             description: "List credit card accounts via Open Finance",
@@ -151,6 +185,22 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ["consentId"],
             },
         },
+        {
+            name: "get_credit_card_bills",
+            description: "Get credit card bills (faturas) via Open Finance",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    consentId: { type: "string", description: "Consent ID" },
+                    creditCardAccountId: { type: "string", description: "Credit card account ID" },
+                    fromDueDate: { type: "string", description: "Start due date (YYYY-MM-DD)" },
+                    toDueDate: { type: "string", description: "End due date (YYYY-MM-DD)" },
+                    page: { type: "number", description: "Page number" },
+                    pageSize: { type: "number", description: "Items per page" },
+                },
+                required: ["consentId", "creditCardAccountId"],
+            },
+        },
         {
             name: "get_credit_card_transactions",
             description: "Get credit card transactions via Open Finance",
@@ -167,6 +217,46 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ["consentId", "creditCardAccountId"],
             },
         },
+        {
+            name: "list_loans",
+            description: "List loan contracts (empréstimos) via Open Finance",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    consentId: { type: "string", description: "Consent ID" },
+                    page: { type: "number", description: "Page number" },
+                    pageSize: { type: "number", description: "Items per page" },
+                },
+                required: ["consentId"],
+            },
+        },
+        {
+            name: "get_loan_payments",
+            description: "Get loan payment schedule via Open Finance",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    consentId: { type: "string", description: "Consent ID" },
+                    contractId: { type: "string", description: "Loan contract ID" },
+                    page: { type: "number", description: "Page number" },
+                    pageSize: { type: "number", description: "Items per page" },
+                },
+                required: ["consentId", "contractId"],
+            },
+        },
+        {
+            name: "list_financings",
+            description: "List financing contracts (financiamentos) via Open Finance",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    consentId: { type: "string", description: "Consent ID" },
+                    page: { type: "number", description: "Page number" },
+                    pageSize: { type: "number", description: "Items per page" },
+                },
+                required: ["consentId"],
+            },
+        },
         {
             name: "list_investments",
             description: "List investment products via Open Finance",
@@ -181,6 +271,66 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ["consentId"],
             },
         },
+        {
+            name: "create_payment_consent",
+            description: "Create payment-initiation consent (e.g., PIX) via Open Finance",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    loggedUserCpf: { type: "string", description: "Logged user CPF" },
+                    creditorName: { type: "string", description: "Creditor name" },
+                    creditorCpfCnpj: { type: "string", description: "Creditor CPF/CNPJ" },
+                    paymentAmount: { type: "string", description: "Payment amount (e.g., '100.00')" },
+                    paymentCurrency: { type: "string", description: "ISO 4217 currency (default: BRL)" },
+                    localInstrument: { type: "string", enum: ["MANU", "DICT", "QRDN", "QRES", "INIC"], description: "PIX local instrument (default: DICT)" },
+                    paymentType: { type: "string", enum: ["PIX", "TED", "TEF", "BOLETO"], description: "Payment type (default: PIX)" },
+                    expirationDateTime: { type: "string", description: "Consent expiration (ISO 8601)" },
+                },
+                required: ["loggedUserCpf", "creditorName", "creditorCpfCnpj", "paymentAmount"],
+            },
+        },
+        {
+            name: "create_payment",
+            description: "Initiate a payment using an authorized payment consent",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    consentId: { type: "string", description: "Authorized payment consent ID" },
+                    creditorAccountIspb: { type: "string", description: "Creditor account ISPB" },
+                    creditorAccountIssuer: { type: "string", description: "Creditor account issuer (agência)" },
+                    creditorAccountNumber: { type: "string", description: "Creditor account number" },
+                    creditorAccountType: { type: "string", enum: ["CACC", "SLRY", "SVGS", "TRAN"], description: "Creditor account type" },
+                    paymentAmount: { type: "string", description: "Payment amount (e.g., '100.00')" },
+                    paymentCurrency: { type: "string", description: "ISO 4217 currency (default: BRL)" },
+                    remittanceInformation: { type: "string", description: "Free-text remittance info" },
+                    qrCode: { type: "string", description: "PIX QR Code payload (optional)" },
+                    proxy: { type: "string", description: "PIX key/proxy (optional)" },
+                },
+                required: ["consentId", "creditorAccountIspb", "creditorAccountIssuer", "creditorAccountNumber", "creditorAccountType", "paymentAmount"],
+            },
+        },
+        {
+            name: "get_personal_qualifications",
+            description: "Get personal customer qualifications (income, occupation) via Open Finance",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    consentId: { type: "string", description: "Consent ID" },
+                },
+                required: ["consentId"],
+            },
+        },
+        {
+            name: "get_business_qualifications",
+            description: "Get business customer qualifications via Open Finance",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    consentId: { type: "string", description: "Consent ID" },
+                },
+                required: ["consentId"],
+            },
+        },
     ],
 }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
@@ -210,6 +360,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     params.set("page-size", String(args.pageSize));
                 return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/accounts/v2/accounts/${args?.accountId}/transactions?${params}`), null, 2) }] };
             }
+            case "get_account_overdraft_limits":
+                return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/accounts/v2/accounts/${args?.accountId}/overdraft-limits`), null, 2) }] };
             case "get_consent":
                 return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/consents/v2/consents/${args?.consentId}`), null, 2) }] };
             case "create_consent": {
@@ -223,6 +375,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
                 return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("POST", "/open-banking/consents/v2/consents", payload), null, 2) }] };
             }
+            case "revoke_consent": {
+                const consentType = args?.consentType || "data";
+                const path = consentType === "payment"
+                    ? `/open-banking/payments/v3/consents/${args?.consentId}`
+                    : `/open-banking/consents/v2/consents/${args?.consentId}`;
+                return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("DELETE", path), null, 2) }] };
+            }
             case "list_credit_cards": {
                 const params = new URLSearchParams();
                 if (args?.page)
@@ -231,6 +390,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     params.set("page-size", String(args.pageSize));
                 return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/credit-cards-accounts/v2/accounts?${params}`), null, 2) }] };
             }
+            case "get_credit_card_bills": {
+                const params = new URLSearchParams();
+                if (args?.fromDueDate)
+                    params.set("fromDueDate", String(args.fromDueDate));
+                if (args?.toDueDate)
+                    params.set("toDueDate", String(args.toDueDate));
+                if (args?.page)
+                    params.set("page", String(args.page));
+                if (args?.pageSize)
+                    params.set("page-size", String(args.pageSize));
+                return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/credit-cards-accounts/v2/accounts/${args?.creditCardAccountId}/bills?${params}`), null, 2) }] };
+            }
             case "get_credit_card_transactions": {
                 const params = new URLSearchParams();
                 if (args?.fromDate)
@@ -243,6 +414,30 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     params.set("page-size", String(args.pageSize));
                 return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/credit-cards-accounts/v2/accounts/${args?.creditCardAccountId}/transactions?${params}`), null, 2) }] };
             }
+            case "list_loans": {
+                const params = new URLSearchParams();
+                if (args?.page)
+                    params.set("page", String(args.page));
+                if (args?.pageSize)
+                    params.set("page-size", String(args.pageSize));
+                return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/loans/v2/contracts?${params}`), null, 2) }] };
+            }
+            case "get_loan_payments": {
+                const params = new URLSearchParams();
+                if (args?.page)
+                    params.set("page", String(args.page));
+                if (args?.pageSize)
+                    params.set("page-size", String(args.pageSize));
+                return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/loans/v2/contracts/${args?.contractId}/payments?${params}`), null, 2) }] };
+            }
+            case "list_financings": {
+                const params = new URLSearchParams();
+                if (args?.page)
+                    params.set("page", String(args.page));
+                if (args?.pageSize)
+                    params.set("page-size", String(args.pageSize));
+                return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/financings/v2/contracts?${params}`), null, 2) }] };
+            }
             case "list_investments": {
                 const investmentType = args?.investmentType || "BANK_FIXED_INCOMES";
                 const params = new URLSearchParams();
@@ -252,6 +447,51 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     params.set("page-size", String(args.pageSize));
                 return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/investments/v1/${investmentType.toLowerCase().replace(/_/g, "-")}?${params}`), null, 2) }] };
             }
+            case "create_payment_consent": {
+                const payload = {
+                    data: {
+                        loggedUser: { document: { identification: args?.loggedUserCpf, rel: "CPF" } },
+                        creditor: {
+                            personType: String(args?.creditorCpfCnpj).length > 11 ? "PESSOA_JURIDICA" : "PESSOA_NATURAL",
+                            cpfCnpj: args?.creditorCpfCnpj,
+                            name: args?.creditorName,
+                        },
+                        payment: {
+                            type: args?.paymentType || "PIX",
+                            currency: args?.paymentCurrency || "BRL",
+                            amount: args?.paymentAmount,
+                            details: { localInstrument: args?.localInstrument || "DICT" },
+                        },
+                        expirationDateTime: args?.expirationDateTime,
+                    },
+                };
+                return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("POST", "/open-banking/payments/v3/consents", payload), null, 2) }] };
+            }
+            case "create_payment": {
+                const payload = {
+                    data: {
+                        consentId: args?.consentId,
+                        creditorAccount: {
+                            ispb: args?.creditorAccountIspb,
+                            issuer: args?.creditorAccountIssuer,
+                            number: args?.creditorAccountNumber,
+                            accountType: args?.creditorAccountType,
+                        },
+                        payment: {
+                            currency: args?.paymentCurrency || "BRL",
+                            amount: args?.paymentAmount,
+                        },
+                        remittanceInformation: args?.remittanceInformation,
+                        qrCode: args?.qrCode,
+                        proxy: args?.proxy,
+                    },
+                };
+                return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("POST", "/open-banking/payments/v3/pix/payments", payload), null, 2) }] };
+            }
+            case "get_personal_qualifications":
+                return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", "/open-banking/customers/v2/personal/qualifications"), null, 2) }] };
+            case "get_business_qualifications":
+                return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", "/open-banking/customers/v2/business/qualifications"), null, 2) }] };
             default:
                 return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
         }
@@ -278,7 +518,7 @@ async function main() {
                 const t = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID(), onsessioninitialized: (id) => { transports.set(id, t); } });
                 t.onclose = () => { if (t.sessionId)
                     transports.delete(t.sessionId); };
-                const s = new Server({ name: "mcp-open-finance", version: "0.1.0" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-open-finance", version: "0.2.0" }, { capabilities: { tools: {} } });
                 server._requestHandlers.forEach((v, k) => s._requestHandlers.set(k, v));
                 server._notificationHandlers?.forEach((v, k) => s._notificationHandlers.set(k, v));
                 await s.connect(t);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codespar/mcp-open-finance",
-  "version": "0.1.2",
-  "description": "MCP server for Open Finance Brasil — accounts, transactions, consents, investments",
+  "version": "0.2.0",
+  "description": "MCP server for Open Finance Brasil — accounts, transactions, consents, credit cards, loans, financings, investments, payment-initiation, customer qualifications",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {

package/server.json

@@ -1,18 +1,18 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.codespar/mcp-open-finance",
-  "description": "MCP server for Open Finance Brasil — accounts, transactions, consents, investments",
+  "description": "MCP server for Open Finance Brasil — accounts, transactions, consents, credit cards, loans, financings, investments, payment-initiation, customer qualifications",
   "repository": {
     "url": "https://github.com/codespar/mcp-dev-brasil",
     "source": "github",
     "subfolder": "packages/banking/open-finance"
   },
-  "version": "0.1.2",
+  "version": "0.2.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@codespar/mcp-open-finance",
-      "version": "0.1.2",
+      "version": "0.2.0",
       "transport": {
         "type": "stdio"
       },

package/src/index.ts

@@ -7,11 +7,21 @@
  * - list_accounts: List customer accounts
  * - get_account_balance: Get account balance
  * - list_transactions: List account transactions
+ * - get_account_overdraft_limits: Get account overdraft limits
  * - get_consent: Get consent details
  * - create_consent: Create a new consent request
+ * - revoke_consent: Revoke an existing consent
  * - list_credit_cards: List credit card accounts
+ * - get_credit_card_bills: Get credit card bills
  * - get_credit_card_transactions: Get credit card transactions
+ * - list_loans: List loan contracts
+ * - get_loan_payments: Get loan payment schedule
+ * - list_financings: List financing contracts
  * - list_investments: List investment products
+ * - create_payment_consent: Create payment-initiation consent
+ * - create_payment: Initiate a payment
+ * - get_personal_qualifications: Get personal customer qualifications
+ * - get_business_qualifications: Get business customer qualifications
  *
  * Environment:
  *   OPEN_FINANCE_BASE_URL — Institution API base URL
@@ -45,7 +55,7 @@ async function getAccessToken(): Promise<string> {
       grant_type: "client_credentials",
       client_id: CLIENT_ID,
       client_secret: CLIENT_SECRET,
-      scope: "openid accounts credit-cards-accounts resources consents investments",
+      scope: "openid accounts credit-cards-accounts resources consents investments loans financings customers payments",
     }),
   });
   if (!res.ok) {
@@ -76,7 +86,7 @@ async function openFinanceRequest(method: string, path: string, body?: unknown):
 }
 
 const server = new Server(
-  { name: "mcp-open-finance", version: "0.1.0" },
+  { name: "mcp-open-finance", version: "0.2.0" },
   { capabilities: { tools: {} } }
 );
 
@@ -123,6 +133,18 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         required: ["consentId", "accountId"],
       },
     },
+    {
+      name: "get_account_overdraft_limits",
+      description: "Get account overdraft (limites) via Open Finance",
+      inputSchema: {
+        type: "object",
+        properties: {
+          consentId: { type: "string", description: "Consent ID" },
+          accountId: { type: "string", description: "Account ID" },
+        },
+        required: ["consentId", "accountId"],
+      },
+    },
     {
       name: "get_consent",
       description: "Get consent details by ID",
@@ -152,6 +174,18 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         required: ["permissions", "expirationDateTime"],
       },
     },
+    {
+      name: "revoke_consent",
+      description: "Revoke an existing consent (data or payment)",
+      inputSchema: {
+        type: "object",
+        properties: {
+          consentId: { type: "string", description: "Consent ID to revoke" },
+          consentType: { type: "string", enum: ["data", "payment"], description: "Consent type (default: data)" },
+        },
+        required: ["consentId"],
+      },
+    },
     {
       name: "list_credit_cards",
       description: "List credit card accounts via Open Finance",
@@ -165,6 +199,22 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         required: ["consentId"],
       },
     },
+    {
+      name: "get_credit_card_bills",
+      description: "Get credit card bills (faturas) via Open Finance",
+      inputSchema: {
+        type: "object",
+        properties: {
+          consentId: { type: "string", description: "Consent ID" },
+          creditCardAccountId: { type: "string", description: "Credit card account ID" },
+          fromDueDate: { type: "string", description: "Start due date (YYYY-MM-DD)" },
+          toDueDate: { type: "string", description: "End due date (YYYY-MM-DD)" },
+          page: { type: "number", description: "Page number" },
+          pageSize: { type: "number", description: "Items per page" },
+        },
+        required: ["consentId", "creditCardAccountId"],
+      },
+    },
     {
       name: "get_credit_card_transactions",
       description: "Get credit card transactions via Open Finance",
@@ -181,6 +231,46 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         required: ["consentId", "creditCardAccountId"],
       },
     },
+    {
+      name: "list_loans",
+      description: "List loan contracts (empréstimos) via Open Finance",
+      inputSchema: {
+        type: "object",
+        properties: {
+          consentId: { type: "string", description: "Consent ID" },
+          page: { type: "number", description: "Page number" },
+          pageSize: { type: "number", description: "Items per page" },
+        },
+        required: ["consentId"],
+      },
+    },
+    {
+      name: "get_loan_payments",
+      description: "Get loan payment schedule via Open Finance",
+      inputSchema: {
+        type: "object",
+        properties: {
+          consentId: { type: "string", description: "Consent ID" },
+          contractId: { type: "string", description: "Loan contract ID" },
+          page: { type: "number", description: "Page number" },
+          pageSize: { type: "number", description: "Items per page" },
+        },
+        required: ["consentId", "contractId"],
+      },
+    },
+    {
+      name: "list_financings",
+      description: "List financing contracts (financiamentos) via Open Finance",
+      inputSchema: {
+        type: "object",
+        properties: {
+          consentId: { type: "string", description: "Consent ID" },
+          page: { type: "number", description: "Page number" },
+          pageSize: { type: "number", description: "Items per page" },
+        },
+        required: ["consentId"],
+      },
+    },
     {
       name: "list_investments",
       description: "List investment products via Open Finance",
@@ -195,6 +285,66 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         required: ["consentId"],
       },
     },
+    {
+      name: "create_payment_consent",
+      description: "Create payment-initiation consent (e.g., PIX) via Open Finance",
+      inputSchema: {
+        type: "object",
+        properties: {
+          loggedUserCpf: { type: "string", description: "Logged user CPF" },
+          creditorName: { type: "string", description: "Creditor name" },
+          creditorCpfCnpj: { type: "string", description: "Creditor CPF/CNPJ" },
+          paymentAmount: { type: "string", description: "Payment amount (e.g., '100.00')" },
+          paymentCurrency: { type: "string", description: "ISO 4217 currency (default: BRL)" },
+          localInstrument: { type: "string", enum: ["MANU", "DICT", "QRDN", "QRES", "INIC"], description: "PIX local instrument (default: DICT)" },
+          paymentType: { type: "string", enum: ["PIX", "TED", "TEF", "BOLETO"], description: "Payment type (default: PIX)" },
+          expirationDateTime: { type: "string", description: "Consent expiration (ISO 8601)" },
+        },
+        required: ["loggedUserCpf", "creditorName", "creditorCpfCnpj", "paymentAmount"],
+      },
+    },
+    {
+      name: "create_payment",
+      description: "Initiate a payment using an authorized payment consent",
+      inputSchema: {
+        type: "object",
+        properties: {
+          consentId: { type: "string", description: "Authorized payment consent ID" },
+          creditorAccountIspb: { type: "string", description: "Creditor account ISPB" },
+          creditorAccountIssuer: { type: "string", description: "Creditor account issuer (agência)" },
+          creditorAccountNumber: { type: "string", description: "Creditor account number" },
+          creditorAccountType: { type: "string", enum: ["CACC", "SLRY", "SVGS", "TRAN"], description: "Creditor account type" },
+          paymentAmount: { type: "string", description: "Payment amount (e.g., '100.00')" },
+          paymentCurrency: { type: "string", description: "ISO 4217 currency (default: BRL)" },
+          remittanceInformation: { type: "string", description: "Free-text remittance info" },
+          qrCode: { type: "string", description: "PIX QR Code payload (optional)" },
+          proxy: { type: "string", description: "PIX key/proxy (optional)" },
+        },
+        required: ["consentId", "creditorAccountIspb", "creditorAccountIssuer", "creditorAccountNumber", "creditorAccountType", "paymentAmount"],
+      },
+    },
+    {
+      name: "get_personal_qualifications",
+      description: "Get personal customer qualifications (income, occupation) via Open Finance",
+      inputSchema: {
+        type: "object",
+        properties: {
+          consentId: { type: "string", description: "Consent ID" },
+        },
+        required: ["consentId"],
+      },
+    },
+    {
+      name: "get_business_qualifications",
+      description: "Get business customer qualifications via Open Finance",
+      inputSchema: {
+        type: "object",
+        properties: {
+          consentId: { type: "string", description: "Consent ID" },
+        },
+        required: ["consentId"],
+      },
+    },
   ],
 }));
 
@@ -220,6 +370,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (args?.pageSize) params.set("page-size", String(args.pageSize));
         return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/accounts/v2/accounts/${args?.accountId}/transactions?${params}`), null, 2) }] };
       }
+      case "get_account_overdraft_limits":
+        return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/accounts/v2/accounts/${args?.accountId}/overdraft-limits`), null, 2) }] };
       case "get_consent":
         return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/consents/v2/consents/${args?.consentId}`), null, 2) }] };
       case "create_consent": {
@@ -233,12 +385,27 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
         return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("POST", "/open-banking/consents/v2/consents", payload), null, 2) }] };
       }
+      case "revoke_consent": {
+        const consentType = (args?.consentType as string) || "data";
+        const path = consentType === "payment"
+          ? `/open-banking/payments/v3/consents/${args?.consentId}`
+          : `/open-banking/consents/v2/consents/${args?.consentId}`;
+        return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("DELETE", path), null, 2) }] };
+      }
       case "list_credit_cards": {
         const params = new URLSearchParams();
         if (args?.page) params.set("page", String(args.page));
         if (args?.pageSize) params.set("page-size", String(args.pageSize));
         return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/credit-cards-accounts/v2/accounts?${params}`), null, 2) }] };
       }
+      case "get_credit_card_bills": {
+        const params = new URLSearchParams();
+        if (args?.fromDueDate) params.set("fromDueDate", String(args.fromDueDate));
+        if (args?.toDueDate) params.set("toDueDate", String(args.toDueDate));
+        if (args?.page) params.set("page", String(args.page));
+        if (args?.pageSize) params.set("page-size", String(args.pageSize));
+        return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/credit-cards-accounts/v2/accounts/${args?.creditCardAccountId}/bills?${params}`), null, 2) }] };
+      }
       case "get_credit_card_transactions": {
         const params = new URLSearchParams();
         if (args?.fromDate) params.set("fromTransactionDate", String(args.fromDate));
@@ -247,6 +414,24 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (args?.pageSize) params.set("page-size", String(args.pageSize));
         return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/credit-cards-accounts/v2/accounts/${args?.creditCardAccountId}/transactions?${params}`), null, 2) }] };
       }
+      case "list_loans": {
+        const params = new URLSearchParams();
+        if (args?.page) params.set("page", String(args.page));
+        if (args?.pageSize) params.set("page-size", String(args.pageSize));
+        return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/loans/v2/contracts?${params}`), null, 2) }] };
+      }
+      case "get_loan_payments": {
+        const params = new URLSearchParams();
+        if (args?.page) params.set("page", String(args.page));
+        if (args?.pageSize) params.set("page-size", String(args.pageSize));
+        return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/loans/v2/contracts/${args?.contractId}/payments?${params}`), null, 2) }] };
+      }
+      case "list_financings": {
+        const params = new URLSearchParams();
+        if (args?.page) params.set("page", String(args.page));
+        if (args?.pageSize) params.set("page-size", String(args.pageSize));
+        return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/financings/v2/contracts?${params}`), null, 2) }] };
+      }
       case "list_investments": {
         const investmentType = (args?.investmentType as string) || "BANK_FIXED_INCOMES";
         const params = new URLSearchParams();
@@ -254,6 +439,51 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (args?.pageSize) params.set("page-size", String(args.pageSize));
         return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", `/open-banking/investments/v1/${investmentType.toLowerCase().replace(/_/g, "-")}?${params}`), null, 2) }] };
       }
+      case "create_payment_consent": {
+        const payload = {
+          data: {
+            loggedUser: { document: { identification: args?.loggedUserCpf, rel: "CPF" } },
+            creditor: {
+              personType: String(args?.creditorCpfCnpj).length > 11 ? "PESSOA_JURIDICA" : "PESSOA_NATURAL",
+              cpfCnpj: args?.creditorCpfCnpj,
+              name: args?.creditorName,
+            },
+            payment: {
+              type: (args?.paymentType as string) || "PIX",
+              currency: (args?.paymentCurrency as string) || "BRL",
+              amount: args?.paymentAmount,
+              details: { localInstrument: (args?.localInstrument as string) || "DICT" },
+            },
+            expirationDateTime: args?.expirationDateTime,
+          },
+        };
+        return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("POST", "/open-banking/payments/v3/consents", payload), null, 2) }] };
+      }
+      case "create_payment": {
+        const payload = {
+          data: {
+            consentId: args?.consentId,
+            creditorAccount: {
+              ispb: args?.creditorAccountIspb,
+              issuer: args?.creditorAccountIssuer,
+              number: args?.creditorAccountNumber,
+              accountType: args?.creditorAccountType,
+            },
+            payment: {
+              currency: (args?.paymentCurrency as string) || "BRL",
+              amount: args?.paymentAmount,
+            },
+            remittanceInformation: args?.remittanceInformation,
+            qrCode: args?.qrCode,
+            proxy: args?.proxy,
+          },
+        };
+        return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("POST", "/open-banking/payments/v3/pix/payments", payload), null, 2) }] };
+      }
+      case "get_personal_qualifications":
+        return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", "/open-banking/customers/v2/personal/qualifications"), null, 2) }] };
+      case "get_business_qualifications":
+        return { content: [{ type: "text", text: JSON.stringify(await openFinanceRequest("GET", "/open-banking/customers/v2/business/qualifications"), null, 2) }] };
       default:
         return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
     }
@@ -276,7 +506,7 @@ async function main() {
       if (!sid && isInitializeRequest(req.body)) {
         const t = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID(), onsessioninitialized: (id) => { transports.set(id, t); } });
         t.onclose = () => { if (t.sessionId) transports.delete(t.sessionId); };
-        const s = new Server({ name: "mcp-open-finance", version: "0.1.0" }, { capabilities: { tools: {} } }); (server as any)._requestHandlers.forEach((v: any, k: any) => (s as any)._requestHandlers.set(k, v)); (server as any)._notificationHandlers?.forEach((v: any, k: any) => (s as any)._notificationHandlers.set(k, v)); await s.connect(t);
+        const s = new Server({ name: "mcp-open-finance", version: "0.2.0" }, { capabilities: { tools: {} } }); (server as any)._requestHandlers.forEach((v: any, k: any) => (s as any)._requestHandlers.set(k, v)); (server as any)._notificationHandlers?.forEach((v: any, k: any) => (s as any)._notificationHandlers.set(k, v)); await s.connect(t);
         await t.handleRequest(req, res, req.body); return;
       }
       res.status(400).json({ jsonrpc: "2.0", error: { code: -32000, message: "Bad Request" }, id: null });