Court Listener MCP Teams Bot

A demonstration project showing how to build a Microsoft Teams bot using the Model Context Protocol (MCP) to provide legal research capabilities through the Court Listener API.

Overview

This project demonstrates:

• Building a custom MCP server as an Azure Function
• Integrating the Court Listener REST API for case law research
• Using Microsoft Dataverse for response caching
• Creating a Teams bot with Bot Framework SDK
• Leveraging Azure OpenAI for natural language understanding
• Connecting MCP clients to standalone MCP servers

Important: This demo uses the Microsoft Bot Framework which is scheduled for end of support on December 31, 2025. You can use this demo beyond that date, but understand that this demo is not intended to be used in production for a long period of time. The demo exists to merely show the concepts of architecture and functionality. For production usage, the dependencies of the web application (Teams Bot) should be updated to use the Microsoft Agents SDK. Once the end-of-support date has been reached, we will update the repo with the necessary changes that leverage the Microsoft Agents SDK.

Architecture

┌──────────────────────────────────────────────────────────────────┐
│                      Microsoft Teams                             │
└────────────────────────────┬─────────────────────────────────────┘
                             │
                             ▼
┌──────────────────────────────────────────────────────────────────┐
│                   Teams Bot (Azure App Service)                  │
│  ┌────────────────────────────────────────────────────────────┐  │
│  │  Bot Framework SDK                                         │  │
│  │  - Receives user messages                                  │  │
│  │  - Routes to Azure OpenAI for intent understanding         │  │
│  │  - Calls MCP server with determined tool & params          │  │
│  │  - Formats and returns results to Teams                    │  │
│  └────────────────────────────────────────────────────────────┘  │
│                                                                  │
│  ┌─────────────────┐          ┌────────────────────────────────┐ │
│  │ Azure OpenAI    │          │    MCP Client                  │ │
│  │ (GPT-4.1)       │          │    - HTTP/JSON-RPC protocol    │ │
│  │                 │          │    - Tool invocation           │ │
│  └─────────────────┘          └────────────────────────────────┘ │
└────────────────────────────────────────┬─────────────────────────┘
                                         │ HTTP/JSON-RPC
                                         ▼
┌──────────────────────────────────────────────────────────────────┐
│              MCP Server (Azure Functions)                        │
│  ┌────────────────────────────────────────────────────────────┐  │
│  │  Microsoft MCP Extension                                   │  │
│  │  - Endpoint: /runtime/webhooks/mcp                         │  │
│  │  - Protocol: JSON-RPC 2.0 (JSON/SSE)                       │  │
│  │                                                            │  │
│  │  MCP Tools (via McpToolTrigger):                           │  │
│  │  • search_opinions - Search court opinions                 │  │
│  │  • get_opinion_details - Get specific opinion              │  │
│  │  • search_dockets - Search dockets/cases                   │  │
│  │  • get_court_info - Get court information                  │  │
│  └────────────────────────────────────────────────────────────┘  │
│                                                                  │
│  ┌──────────────────────┐      ┌───────────────────────────────┐ │
│  │ Dataverse Cache      │      │ Court Listener Client         │ │
│  │ - 30-day TTL         │      │ - REST API integration        │ │
│  │ - SHA-256 keys       │      │                               │ │
│  └──────────────────────┘      └───────────────────────────────┘ 

... [View full README on GitHub](https://github.com/microsoft/IF-MCP-Server-for-Microsoft-Teams#readme)