How do I use Niagara 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., "@Niagara MCP Server Can you track shipment 12345?" 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.

Niagara MCP Server

by hassancr7240-ai

Overview Schema Source Related Servers Discussions Admin

Python

Remote

Niagara MCP Server — APIM Dynamic Discovery

An MCP (Model Context Protocol) server deployed on Azure that dynamically reads all APIs from Azure API Management and exposes them as AI tools to Copilot Studio. No hardcoding. No static files. APIM is the single source of truth.

Branch: Active development on development. main is protected.

How It Works

Copilot Studio (user types plain English)
        |
        |  MCP protocol — Streamable HTTP
        v
registry-mcp-server  (Azure App Service — Docker container)
  ├── http_app_apim.py   → exposes /mcp endpoint, accepts Copilot Studio connections
  ├── server_apim.py     → MCP protocol: handles tools/list and tools/call
  ├── apim_dynamic.py    → reads all APIs live from APIM Management API, filters, routes
  ├── registry.py        → fallback only (returns empty if tools_registry.json missing)
  ├── dispatcher.py      → fallback HTTP dispatcher for registry-based tools
  └── apim_poc/policy.xml → APIM native gateway policy (POC reference, not active)
        |
        |  Real HTTP calls with subscription key
        v
Azure API Management (apim-dev-intg)
  ├── Function Apps  (fn-dev-bark, fn-dev-dimitri-getshipmentfromwms, fn-dev-purchase-orders ...)
  ├── Logic Apps     (dimitri-otmtodimitriupdate, ebs-to-dimitri, service-cloud-integration ...)
  └── REST APIs      (livetracking-getShipments, uomconversiontoerp, otmgenericapi ...)

Related MCP server: OpenAPI REST MCP Server

Code Files

File	What it does
`app/mcp_server/apim_dynamic.py`	Core. Authenticates via Managed Identity, calls `management.azure.com`, reads all 56 APIs, filters out EDI/B2B prefixes, converts each operation to MCP tool format, routes tool calls to correct APIM endpoint
`app/mcp_server/server_apim.py`	MCP protocol layer. Handles `tools/list` (calls apim_dynamic) and `tools/call` (routes to apim_dynamic or fallback)
`app/mcp_server/http_app_apim.py`	Web server. Exposes `/mcp` Streamable HTTP endpoint for Copilot Studio and `/sse` legacy endpoint
`app/mcp_server/registry.py`	Fallback only. Loads tools from `tools_registry.json` if it exists. File is deleted — returns empty dict
`app/mcp_server/dispatcher.py`	Fallback HTTP dispatcher. Used only if APIM discovery fails
`apim_poc/policy.xml`	APIM native gateway approach (Plan A / POC). Documents rate limiting, JWT auth, and CORS policies

API Discovery Logic (apim_dynamic.py)

Authenticates using App Service Managed Identity — no passwords, no hardcoded credentials
Calls management.azure.com → reads all 56 APIs from apim-dev-intg
Checks for mcp-enabled tag — if any API is tagged, shows only tagged ones. If none tagged, shows all
Filters out EDI/B2B system callbacks by prefix: o2c_, p2p_, b2b_, echo_api, fourkites_, fap_dev_, 3pl_ofc_, fn_dev_edi_
Converts remaining 53 business tools to MCP format with name, description, and input schema from APIM metadata
Returns to Copilot Studio — happens live on every session, no caching

Any new Logic App or Function App published to APIM automatically appears in Copilot Studio on the next session. Zero code change, zero redeploy.

Security Controls

Control	Status
Managed Identity — no credentials in code	Active
All secrets in App Service env vars — never in code or git	Active
APIM audit logging via Azure Monitor	Active automatically
EDI/B2B filter — AI cannot see system integration endpoints	Active
`mcp-enabled` tag — whitelist specific APIs for AI access	Ready — APIM admin adds tags
Rate limiting — 100 calls/min per subscription	Ready — one line in policy.xml
JWT Azure AD authentication on /mcp endpoint	Ready — one line in policy.xml

Tech Stack

Technology	Version	Purpose
Python	3.11	Server language
MCP SDK	1.28.1	MCP protocol
Starlette	0.41.3	Web framework
Uvicorn	0.32.1	ASGI server
HTTPX	0.28.1	Async HTTP calls to APIM
Azure Identity SDK	≥1.15.0	Managed Identity authentication
Docker	—	Containerization
Azure App Service	—	Hosting
Azure Container Registry	acrregistrymcp	Docker image storage
APIM Management API	2022-08-01	Dynamic API discovery

Azure Resources

Resource group: rg-dev-IntegrationTeamAI — Subscription: Niagara Development

Resource	Type	Purpose
`registry-mcp-server`	App Service	MCP server — live at azurewebsites.net
`acrregistrymcp`	Container Registry	Docker image storage
`apim-dev-intg`	API Management	Source of all 56 APIs

Environment Variables (App Service)

Variable	Purpose
`AZURE_SUBSCRIPTION_ID`	Azure subscription hosting APIM
`APIM_RESOURCE_GROUP`	Resource group of APIM instance
`APIM_SERVICE_NAME`	APIM name — currently `apim-dev-intg`
`APIM_BASE_URL`	APIM gateway URL
`APIM_SUBSCRIPTION_KEY`	Subscription key for All APIs product — sent on every tool call
`APIM_MCP_TAG`	Tag filter — default `mcp-enabled`

Live URLs

URL	Purpose
`https://registry-mcp-server.azurewebsites.net/mcp`	MCP endpoint — Copilot Studio connects here
`https://registry-mcp-server.azurewebsites.net/sse`	Legacy SSE endpoint
`https://apim-dev-intg.azure-api.net`	APIM gateway

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

Zyla API Hub A
com.zylalabs
Discover and call 10,000+ production APIs from one MCP server. Pay-per-call billing for AI agents.
Developer Tools
82
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
nexusOAuth
com.civic
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Agent Orchestration Developer Tools App Automation
2
CraloOAuth
ai.cralo
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Agent Orchestration Developer Tools
1

Related MCP Servers

SwaggerMcp
API Testing Developer Tools RAG Systems
NakiriYuuzu
A
license
A
quality
D
maintenance
A service that dynamically generates MCP tools from Swagger/OpenAPI documentation, allowing Claude Desktop to directly invoke REST APIs through natural language.
Updated a year ago (2025-07-29 02:47 UTC)
5
10 npm
MIT
OpenAPI REST MCP Server
Developer Tools Code Execution API Testing
SaraNazeer27
F
license
Not graded
quality
D
maintenance
Dynamically converts any REST service's OpenAPI specification into MCP tools, enabling interaction with REST endpoints through natural language. Supports Spring Boot services and includes auto-discovery for common API configurations.
Updated a year ago (2025-08-22 04:47 UTC)
-
Azure APIM + MCP Server Demo
Cloud Platforms E-commerce & Retail API Testing
kathirt
A
license
Not graded
quality
D
maintenance
Exposes backend APIs through Azure API Management as an MCP server to enable AI assistants to interact with product catalogs and order systems. It provides standardized tools for searching products, retrieving details, and managing orders via the Model Context Protocol.
Updated 8 months ago (2026-01-15 22:44 UTC)
MIT
OpenAPI MCP Server
API Testing Developer Tools AI & Machine Learning
lotusbaba
F
license
Not graded
quality
D
maintenance
Dynamically exposes any OpenAPI/Swagger API as tools for AI assistants, automatically generating MCP tools from OpenAPI specs with authentication support.
Updated a year ago (2025-07-28 20:08 UTC)
-