# MCP servers | Server | Port | What it does | Credential | |---|---|---|---| | [`azure-discovery`](azure-discovery/) | 8111 | Read-only discovery of an Azure estate | The customer's, per project | | [`aws-discovery`](aws-discovery/) | 8112 | Read-only discovery of an AWS estate | The customer's, per project | | [`gcp-discovery`](gcp-discovery/) | 8113 | Read-only discovery of a Google Cloud estate | The customer's, per project | | [`cloud-knowledge`](cloud-knowledge/) | 8114 | Well-Architected guidance from each hyperscaler | Kyndryl's, tenant-wide | | [`alz-discovery-sample`](alz-discovery-sample/) | 8110 | The Meridian sample estate, for evals | None | Customers grant access as described in [docs/customer-cloud-access.md](../docs/customer-cloud-access.md). ## Working on a server A server's folder is rendered: **don't edit `server.py` by hand.** The sources are: | Path | What it holds | |---|---| | `.server.yaml` | The definition: tools, connection fields, added packages | | `_common/tool_support.py` | Redaction, anonymisation, paging and evidence, inlined into every server | | `_common/_support.py` | Each provider's code | | `_common/test_contract.py` | The rules every server must pass | | `/tests/test_*.py` | That server's own tests | After changing a source, render and test: ```sh python3 scripts/render_mcp_server.py mcp-servers/.server.yaml --out mcp-servers/ \ --platform ~/platform-engineering/kyndryl-agent-builder/modernization-platform python3 scripts/test_mcp_servers.py ``` ## Rules - **Store a discovery server's connection per project, never tenant-wide.** The gateway uses a tenant-wide credential for every project without its own, so one customer's access would serve another's engagement. - **Store `cloud-knowledge`'s connection tenant-wide.** It holds only Kyndryl's access. - **Read-only.** Don't add a tool that creates, changes or deletes anything. - **Every reply goes through `_scrub`,** which removes secrets and anonymises people. - **Knowledge queries come only from the fixed lists** in `_common/knowledge_support.py`. Never add a free-text field.