Skip to main content
Glama
ParabankLab

ParaBank MCP Server

by ParabankLab
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

created by

Tamás András Péter 2026-08

ParaBank MCP Client & Server (Gemini API Integration)

A TypeScript implementation of the Model Context Protocol (MCP) integrated with Google's latest Gemini API (@google/genai). This project acts as an intelligent AI agent bridge: it dynamically discovers tools provided by a local ParaBank MCP server over standard input/output (stdio), converts the tool definitions into Gemini-compatible function declarations, and executes requested banking operations on demand.

🏗️ Architecture Overview

┌─────────────────────────────────────────────────────────────────────────────┐ │ MCP CLIENT │ │ (src/client/gemini.ts) │ │ │ │ 1. Starts MCP Server via Child Process (stdio) │ │ 2. Queries Server Capabilities via listTools() │ └──────────────┬──────────────────────────────────────────────▲───────────────┘ │ Convert MCP Tools │ Tool Output │ to Function Declarations │ JSON Payload ▼ │ ┌──────────────────────────────┐ ┌───────────────┴───────────────┐ │ GOOGLE GEMINI API │ │ MCP SERVER │ │ (gemini-3.6-flash) │ │ (dist/index.js) │ │ │ │ │ │ Evaluates User Prompt & │ │ Executes requested banking │ │ emits structured ├─────────────►│ action against ParaBank API │ │ FunctionCall object │ FunctionCall │ or local mocks │ └──────────────────────────────┘ Details └───────────────────────────────┘

Protocol Flow

  1. Tool Discovery: The client spawns the compiled MCP server sub-process (dist/index.js) and fetches available tool definitions.

  2. Declaration Mapping: Tool schemas from the MCP server are dynamically mapped to Google Gemini's standard FunctionDeclaration schema format.

  3. Intent Recognition: User prompts are sent to gemini-2.5-flash. If Gemini determines a banking operation is required, it returns a functionCall request.

  4. Execution over Stdio: The client intercepts the functionCall, invokes mcpClient.callTool() over the bidirectional stdio transport layer, and outputs the result.

Related MCP server: FinAgent MCP

🛠️ Tech Stack

  • Language: Node.js v24+ & TypeScript (ESM)

  • AI Model Engine: Google Gen AI SDK (@google/genai)

  • Protocol Standard: Model Context Protocol SDK (@modelcontextprotocol/sdk)

  • Target Services: ParaBank Banking Operations

🚀 Getting Started

Prerequisites

1. Installation

Clone the repository and install the project dependencies:

git clone [https://github.com/your-username/parabank-MCP-Gemini.git](https://github.com/your-username/parabank-MCP-Gemini.git)
cd parabank-MCP-Gemini
npm install

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MifosX Self Service MCP by openMF

    MifosX Self Service MCPofficial

    openMF
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI-driven banking workflows through secure interaction with Apache Fineract/MifosX Self-Service APIs, including authentication, account management, loans, savings, and transfers.
    9
    Mozilla Public 2.0

  • FinAgent MCP

    agentfinRH
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables LLMs to access banking, investment, and cryptocurrency data through a standardized MCP interface, featuring Plaid integration for account and transaction data and Robinhood for crypto trading with audit trails.
    1
    -

  • Procfy

    mcp-dir
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables financial management through the Procfy API, allowing AI agents to manage transactions, bank accounts, contacts, and more via natural language.
    1
    MIT

  • OpenBudget MCP Server

    markets-ai
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to access and manage personal financial data from US institutions and manual entries, including transactions, balances, liabilities, and investments.
    MIT