Which integrations are available for this server?

Provides access to DuckDB databases, enabling query execution, schema inspection, and validation for financial analytics. Provides access to PostgreSQL databases, enabling query execution, schema inspection, and validation for financial analytics. Provides access to SQLite databases, enabling query execution, schema inspection, and validation for financial analytics. Provides access to Stripe billing and payment data for financial analytics and reporting.

How do I use fin-copilot-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@fin-copilot-mcp Compare Q4 earnings for Apple and Microsoft." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

fin-copilot-mcp

by JediPercy

Overview Schema Related Servers Score Discussions

Python

Hybrid

Multi-Agent Financial Analytics Copilot (`fin-copilot-mcp`)

CI/CD Pipeline Python 3.11+ Code Style: Ruff License: MIT

An enterprise-grade, deterministic multi-agent financial analytics engine built on Anthropic's Model Context Protocol (MCP) and Claude 3.5 Sonnet. The system processes complex natural language financial queries, translates them into dialect-validated PostgreSQL / DuckDB SQL, pulls live telemetry/market data, and executes a self-healing verification loop before presenting synthesized results.

🏗 Architecture & Agent Topology

The system uses specialized, domain-isolated agents decoupled from underlying tools using MCP JSON-RPC protocol standards.

                    ┌─────────────────────────────────────────┐
                    │       User Query Interface / API       │
                    └────────────────────┬────────────────────┘
                                         │
                                         ▼
                    ┌─────────────────────────────────────────┐
                    │ Orchestrator Agent (Claude 3.5 Sonnet)  │
                    └────────────────────┬────────────────────┘
                                         │
         ┌───────────────────────────────┼───────────────────────────────┐
         │ (MCP Protocol)                │ (MCP Protocol)                │ (MCP Protocol)
         ▼                               ▼                               ▼
┌──────────────────┐           ┌──────────────────┐           ┌──────────────────┐
│  mcp-server-sql  │           │mcp-server-stripe │           │mcp-server-market │
│ (PostgreSQL/Duck)│           │  (Billing Specs) │           │ (YFinance API)   │
└────────┬─────────┘           └──────────────────┘           └──────────────────┘
         │
         │ (Execution Error)
         ▼
┌──────────────────┐
│  Self-Healing    │ ── (Retry Stack Trace) ──► [ Orchestrator Agent ]
│  Validation Loop │
└──────────────────┘

Related MCP server: MCP Autonomous Data Agent

🔑 Key Features

MCP-Native Architecture: Fully decoupled tool servers using standard JSON-RPC over stdio / Server-Sent Events (SSE).
Self-Healing Text-to-SQL Loop: Runs deterministic dry-run verification (EXPLAIN) before execution. Automatically captures AST/syntax errors and feeds stack traces back to Claude for up to 3 repair retries.
Double-Entry Validation: Micro-agent verifying mathematical consistency, row cross-totals, and currency alignment prior to output synthesis.
Strict Type & Schema Safety: Runtime validation via Pydantic v2 and static type checking with MyPy.
Cross-Platform Developer Experience: Powers setup, linting, formatting, and testing on Windows (via PowerShell / py) and Linux/macOS seamlessly.

🛠 Tech Stack

Component	Technology	Purpose
LLM / Reasoning	Claude 3.5 Sonnet (`anthropic`)	Intent decomposition, tool orchestration, and SQL generation
Protocol Layer	FastMCP / Model Context Protocol	Standardized tool/resource encapsulation over JSON-RPC
Analytical Engine	PostgreSQL / DuckDB / SQLite	OLAP/OLTP query execution, AST validation, and schema inspection
Market Data	Yahoo Finance (`yfinance`)	Macroeconomic benchmarks, equity quotes, and volume metrics
Configuration	`pydantic-settings`	Type-safe environment management and secret handling
Developer Tooling	`uv` / `pip`, `ruff`, `mypy`, `pytest`	Hermetic builds, linting, typing, and testing

📁 Repository Structure

fin-copilot-mcp/
├── .github/
│   └── workflows/
│       └── ci.yml                 # CI pipeline (lint, type-check, unit & integration tests)
├── config/
│   └── mcp_servers.json          # System tool topologies and connection mappings
├── docker/
│   ├── Dockerfile.orchestrator    # Production container for agent runtime
│   └── Dockerfile.mcp-server      # Container specification for standalone MCP servers
├── src/
│   └── fin_copilot/
│       ├── core/                  # Base configuration, logging, exceptions
│       ├── mcp_servers/           # Standalone FastMCP server modules (SQL, Stripe, Market)
│       ├── agents/                # Orchestrator agent logic, prompts, and healing loops
│       └── utils/                 # Telemetry and formatting helpers
├── tests/
│   ├── unit/                      # FastMCP tool & resource unit tests
│   ├── integration/               # Multi-agent self-healing loop tests
│   └── evals/                     # Benchmarks for Text-to-SQL translation accuracy
├── scripts/
│   ├── setup.ps1                  # Windows PowerShell setup script
│   └── setup.sh                   # Linux / macOS bash setup script
├── pyproject.toml                 # Packaging, dependencies, and linter rules
├── .gitignore                     # Industry-standard Python ignore rules
├── .env.example                   # Environment variable template
└── README.md

🚀 Quickstart

Prerequisites

Python >= 3.11
uv or standard pip
Anthropic API Key (ANTHROPIC_API_KEY)

Installation & Setup

On Windows (PowerShell):

# 1. Clone the repository
git clone https://github.com/your-username/fin-copilot-mcp.git
cd fin-copilot-mcp

# 2. Run PowerShell Setup Script
.\scripts\setup.ps1

# 3. Configure environment variables
Copy-Item .env.example .env

On Linux / macOS (Bash):

# 1. Clone the repository
git clone https://github.com/your-username/fin-copilot-mcp.git
cd fin-copilot-mcp

# 2. Run Setup Script
chmod +x ./scripts/setup.sh
./scripts/setup.sh

# 3. Configure environment variables
cp .env.example .env

🛡 Security & Guardrails

Read-Only Database Connections: SQL MCP server limits execution strictly to SELECT statements and dialect dry-runs.
Token Sandboxing: API keys are isolated within environment settings classes and never exposed across tool execution boundaries.
Data Masking: Structural masking applied to sensitive financial attributes prior to model context generation.

📜 License

Distributed under the MIT License. See LICENSE for details.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

license - permissive license

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

desk
Finance Research & Data Autonomous Agents
Saivikaskillamsetty
F
license
A
quality
B
maintenance
Provides multi-agent equity research for US markets with provenance-backed financial data from SEC EDGAR, technicals, macro, and Alpaca paper trading, enforcing risk limits and journaling theses.
Updated 15 days ago (2026-08-16 15:23 UTC)
27
MCP Autonomous Data Agent
Finance Databases Autonomous Agents
fortuneMog
F
license
Not graded
quality
C
maintenance
Enables secure, read-only analytical querying of financial data through natural language, with built-in SQL injection defense and automatic query repair.
Updated 8 days ago (2026-08-23 12:54 UTC)
trustflow-companyx
Databases Search RAG Systems
SakJaeLim
A
license
Not graded
quality
B
maintenance
Enables natural language queries to be converted into policy-verified SQL, vector search, and knowledge graph plans, with evidence-backed answers and an audit log.
Updated 7 days ago (2026-08-25 05:51 UTC)
1
Apache 2.0
Thesis
Finance Research & Data
Bilaltariq98
A
license
Not graded
quality
D
maintenance
Enables AI agents to access and synthesize per-ticker financial research data from multiple providers within a private, self-hosted workspace.
Updated 7 days ago (2026-08-24 10:45 UTC)
5
MIT

View all related MCP servers

Related MCP Connectors

Drillr — The financial MCP for AI agents
The financial MCP for AI agents - 90+ financial tables, SEC filings, signals, alt-data.
ko-mcp
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
Hive Intelligence MCP
Evidence-backed crypto due diligence with sources, freshness, and a runtime receipt on every call.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/JediPercy/fin-copilot-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Multi-Agent Financial Analytics Copilot (fin-copilot-mcp)