How do I use Teepy MCP Server?

1. Click on "Deploy 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., "@Teepy MCP Server Show me unpaid invoices" 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.

Teepy MCP Server

by SajedehAdelia

Overview Schema Source Related Servers Discussions Admin

Python

Local

Teepy × Theopy — my contribution (sanitized extract)

This repository is a sanitized extract of Teepy, Kozea's proprietary pharmacy-management ERP (private repository, years of work by a full team, confidential to Kozea and its clients).

It exists to show, publicly and without breaching confidentiality, the code I personally wrote to connect Teepy to Theopy, an AI assistant I built as part of my RNCP39583 "Experte en Développement Logiciel" certification.

Every file and folder from the real Teepy repository is present here, at its real path, so the overall structure of the application is visible — but only the files I personally authored keep their real content. Everything else has been emptied (zero bytes) on purpose. This repo carries no git history from the original: only Teepy's own private repository has that.

Where my contribution sits in the architecture

 ┌─────────────────────────────────────────────────────-─────────────────┐
 │  THEOPY  (public, separate repo)                                      │
 │  AI assistant — Gemini / Ollama brain, chat UI, login                 │
 └────────────────────────────────┬──────────────────────────────────────┘
                                  │  MCP protocol over SSE
                                  │  initialize → tools/list → tools/call
                                  ▼
┌──────────────────────────────────────────────────────────────────────┐
│  TEEPY  (this repo — sanitized)                                      │
│                                                                      │
│  ┌──────────────────────────────────────────────────────────────┐    │
│  │ mcp_server.py                                        ★ MINE  │    │
│  │ FastMCP entrypoint - boots the MCP server on :5001           │    │
│  └────────────────────────────┬─────────────────────────────────┘    │
│                               │                                      │
│  ┌────────────────────────────▼───────────────────────────────--─┐   │
│  │ mcp_tools/                                           ★ MINE   │   │
│  │  core.py       - identity resolution via MCP `meta`,          │   │
│  │                  requires_role() access control               │   │
│  │  invoices.py   - factures  (administrator/manager/commercial) │   │
│  │  customers.py  - clients   (administrator/manager/commercial) │   │
│  │  plannings.py  - plannings (administrator/manager/operator)   │   │
│  │  sessions.py   - sessions  (+ contractor)                     │   │
│  │  reminders.py  - relances  (administrator/manager/commercial) │   │
│  └────────────────────────────┬───────────────────────────────-──┘   │
│                               │  calls agent_* functions             │
│  ┌────────────────────────────▼──────────────────────────────-───┐   │
│  │ teepy/routes/theopy/                                 ★ MINE   │   │
│  │  base.py, customer.py, invoice.py, planning.py,               │   │
│  │  reminder.py, session.py                                      │   │
│  │  → agent-facing business logic, wrapping Teepy's existing     │   │
│  │    repositories/models                                        │   │
│  └────────────────────────────┬─────────────────────────────-────┘   │
│                               │                                      │
│  ┌────────────────────────────▼─────────────────────────-────────┐   │
│  │ teepy/routes/theopy_auth.py                          ★ MINE   │   │
│  │  POST /api/theopy/authenticate                                │   │
│  └────────────────────────────┬───────────────────────────────-──┘   │
│                               │  queries through                     │
│  ┌────────────────────────────▼─────────────────────────────-────┐   │
│  │ teepy/models/, teepy/repositories/, teepy/services/,          │   │
│  │ teepy/routes/ (rest), teepy/templates/, teepy/static/, ...    │   │
│  │                                        ○ PRE-EXISTING TEEPY   │   │
│  │        proprietary ERP - content redacted in this repo        │   │
│  └────────────────────────────┬───────────────────────────────-──┘   │
│                               │                                      │
│  ┌────────────────────────────▼────────────────────────────-─────┐   │
│  │ PostgreSQL (Teepy production database)                        │   │
│  └────────────────────────────────────────────────────────────--─┘   │
└────────────────────────────────────────────────────────────────--────┘

★ MINE = full, real content, kept as-is. ○ PRE-EXISTING TEEPY = real file/folder structure preserved, content emptied.

Related MCP server: tebra-mcp-server

What's mine, in full

Path	What it is
`mcp_server.py`	FastMCP entrypoint for the MCP server
`mcp_tools/` (6 files)	Role-based access control layer over every MCP tool
`teepy/routes/theopy/` (6 files)	Agent-facing business logic (customers, invoices, plannings, reminders, sessions)
`teepy/routes/theopy_auth.py`	`POST /api/theopy/authenticate` - the endpoint Theopy's login calls
`test/theopy/` (7 files)	Tests for the MCP tools and agent-facing functions, run against real business logic and a real database
`test/test_theopy_auth.py`	Tests for the authentication endpoint
`Makefile`	Includes commands I added: `theopy-serve`, `mcp-inspect`, `install-db-test`
`docker-compose.yml`	MCP server port (`5001`) and networking added for Theopy to reach Teepy
`sql/dev_data.sql`	Additional seed rows I added (synthetic dev data only, not real customer data) for realistic testing
`requirements/`, `uv.lock`	Dependency additions for the MCP integration

teepy/__init__.py is intentionally emptied too, even though I added 2 lines to it (registering the theopy_auth blueprint) - the file is overwhelmingly pre-existing Teepy bootstrap code, not mine, so it follows the same rule as everything else outside the list above.

Links

Theopy (the AI assistant, fully public): https://github.com/SajedehAdelia/Theopy
Teepy (the real repository, private - access on request): https://github.com/Kozea/teepy

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

ActivitySlowing

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Airbyte AgentsOAuth
io.github.airbytehq
Let AI agents query data and act across all your business apps via MCP.
Data Platforms AI & Machine Learning RAG Systems
2
ProxoriaOAuth
com.proxoria.api
Connect your business apps to your MCP compatible AI in 1 click
App Automation Workplace & Productivity
2
cliniko A
io.usefulapi
Hosted MCP server for Cliniko — patients, appointments, availability, and invoices for AI agents.
Biology & Medicine Calendar Management CRM
172
Artificial Wit AIOAuth
com.artificialwit
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
ERP Systems CRM Knowledge & Memory
2

Related MCP Servers

mcp_odoo_fresh
ERP Systems CRM
josefdc
A
license
A
quality
D
maintenance
Enables AI agents to interact with Odoo ERP to perform sales tasks such as searching clients and products, and creating and confirming quotations via the MCP protocol.
Updated a year ago (2025-07-18 03:41 UTC)
5
2
MIT
tebra-mcp-server
Biology & Medicine Finance
jamesrosing
A
license
A
quality
A
maintenance
MCP server for Tebra practice management that gives AI agents access to 45 tools for patients, appointments, billing, documents, and clinical data via SOAP and FHIR APIs.
Updated 14 days ago (2026-09-06 18:29 UTC)
33
476 npm
1
MIT
halaxy-mcp
Biology & Medicine Health & Wellness Payments & Billing
ryanhunt
A
license
Not graded
quality
B
maintenance
MCP server that lets AI assistants query your Halaxy practice-management data—appointments, invoices, referrals, and practitioners—via natural language, exposing read-only tools for daily schedules, billing status, and session limits.
Updated a month ago (2026-08-22 07:57 UTC)
GPL 3.0
Doctor Appointment MCP Server
Biology & Medicine Calendar Management
josh747jr
F
license
Not graded
quality
B
maintenance
Enables AI agents to manage doctor appointments by creating, finding, checking status, canceling, and rescheduling appointments through an MCP server that connects to an external appointment REST API.
Updated a month ago (2026-08-19 16:58 UTC)
-

Teepy × Theopy — my contribution (sanitized extract)

Where my contribution sits in the architecture

What's mine, in full

Links

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

mcp_odoo_fresh

tebra-mcp-server

halaxy-mcp

Doctor Appointment MCP Server