# **TIBCO Flogo® Model Context Protocol (MCP) Samples**

Build and deploy **MCP servers** with **TIBCO Flogo®** — the low-code way to expose enterprise business data and operations as AI-accessible tools. These samples demonstrate how to create MCP servers that AI agents (Claude Desktop, GitHub Copilot, Cursor, custom LLM apps) can discover and call using natural language, turning any integration flow into an AI-ready tool with zero boilerplate.

---

## Samples

| # | Sample | Key Feature | Description |
|---|--------|-------------|-------------|
| 1 | [Customer 360](./Customer360/) | Basic MCP Server | Expose customer, product, and sales data as MCP tools and query via AI agent |
| 2 | [Customer 360 with Auth](./Customer360WithAuth/) | HTTPS + JWT Auth | Same as Customer 360, secured with TLS encryption and JWT token authentication |
| 3 | [Customer 360 with Prompts & Resources](./Customer360WithPromptsAndResources/) | All 3 MCP Primitives | Tools, Resources (static + dynamic URIs), and Prompts working together |
| 4 | [MCP Stateless Server](./MCP_Stateless_Server/) | Stateless Design | Product catalog with `statelessServer = true` — no session tracking, horizontally scalable |
| 5 | [MCP Stateful Server](./MCP_Stateful_Server/) | Stateful Wizard | Multi-step loan application with `Mcp-Session-Id` and file-based state persistence |
| 6 | [MCP Tool Annotations](./MCP_Tool_Annotations/) | Tool Annotation Hints | Banking operations demonstrating `readOnly`, `destructive`, `idempotent`, and `openWorld` hints |
| 7 | [Smart Incident Response Assistant](./Smart_Incident_Response_Assistant/) | Elicitation, Logging, Sampling | Interactive incident intake form, real-time audit logging, and LLM-delegated root-cause analysis |
| 8 | [Customer Health Monitor](./customer-health-monitor/) | Multi-Source Integration | Unified customer insights from Salesforce, Google Sheets, and PostgreSQL |

---

## Learning Path

**Start here** if you're new to MCP in Flogo:

1. **Customer 360** — Foundation pattern: REST API backend + MCP server frontend with simple read-only tools
2. **Customer 360 with Auth** — Add production-ready security (TLS + JWT)
3. **Customer 360 with Prompts & Resources** — Learn when to use Resources vs Tools vs Prompts
4. **Stateless vs Stateful** — Understand the design trade-off for your use case
5. **Tool Annotations** — Guide AI client behavior with annotation hints
6. **Smart Incident Response** — Advanced features (Elicitation, Logging, Sampling)
7. **Customer Health Monitor** — Real-world multi-source integration

---

## Prerequisites

- **TIBCO Flogo® 2.26.1 or later** (Smart Incident Response requires 2.26.3+)
  - For more information, refer to the [MCP Connector documentation](https://docs.tibco.com/pub/flogo/latest/doc/html/Default.htm#connectors/mcp/mcp-overview.htm)
- **AI Agent client** for testing: [Claude Desktop](https://claude.ai/download), GitHub Copilot in VS Code, or any MCP-compatible client
- **TLS certificates** (required only for the Auth sample)

## Quick Start

1. Clone or download this repository.
2. Open the `flogo-enterprise-hub` folder in VS Code with the Flogo extension installed.
3. Navigate to a sample folder and open the `.flogo` file.
4. Run the app from VS Code.
5. Configure your AI agent client to connect to the MCP server endpoint (typically `http://localhost:<port>/mcp`).
6. Start querying your data using natural language.

See each sample's individual `README.md` for detailed configuration, port numbers, and usage instructions.

---

## Feedback

Please contact us at [integration-pm@tibco.com](mailto:integration-pm@tibco.com) with any queries, feedback, or comments.

---

<!-- SEO Keywords: MCP Server, Model Context Protocol, Build MCP Server, MCP Tools, MCP Resources, MCP Prompts, MCP Authentication, MCP Elicitation, MCP Sampling, Stateless MCP, Stateful MCP, Tool Annotations, AI Agent Tools, LLM Integration, Claude Desktop MCP, GitHub Copilot MCP, Low-Code MCP Server, Enterprise AI, TIBCO Flogo, iPaaS, No-Code AI Integration -->

**Topics:** `MCP Server` · `Model Context Protocol` · `AI Agent Tools` · `Low-Code` · `Claude Desktop` · `GitHub Copilot`
