Telepath AI Demo Guide
Welcome. This guide lets you explore a live, national-scale telecom operator estate through AI agents, using nothing but MCP tools. There is no software to install on your side beyond an MCP client (Claude Desktop, Le Chat, or any MCP-capable agent). You will connect to a running environment, ask questions in natural language, and watch the agent orchestrate governed, auditable actions across separate carrier systems.
Everything you touch is a simulation built for demonstration. Break things, inject faults, place orders. If you want a clean slate, email demo@akuig.com and we will reset it for you.
What you are looking at
Telepath AI is vendor-agnostic MCP middleware that lets AI agents take governed, auditable actions on real telecom OSS/BSS systems through TM Forum Open APIs. Carriers run their business on siloed systems: one for customers and billing, another for the physical network, another for trouble tickets, another for infrastructure. Those silos rarely talk to each other. Telepath exposes each of them through the Model Context Protocol so an agent can reason and act across all of them in a single conversation, linked only by customer ID, exactly as a real carrier estate works.
The environment you are connecting to is a complete operator network: a national core with residential and corporate accounts, live network topology, billing, SLAs, trouble ticketing, and sovereign GPU infrastructure. Every action the agent takes is logged to an audit trail.
The six systems
You connect to six independent MCP servers. Each represents a different carrier system, and they are linked only by customer ID, the way real estates are.
| System | What it represents | URL |
|---|---|---|
| BSS | Customers, product catalogue, orders, billing, quotes, invoices, disputes, SLA terms (TMF620/622/629/637/640/648/678 and more) | https://akuig-bss.ngrok.dev/mcp |
| ENM | The physical/logical network: elements, topology, alarms, fault management, SLA risk, path diversity | https://akuig-enm.ngrok.dev/mcp |
| ITSM Local | Trouble tickets (TMF621), self-hosted. Recommended default for ticketing | https://akuig-itsm-local.ngrok.dev/mcp |
| Bare Metal | Sovereign data centre server and GPU provisioning | https://akuig-bare-metal.ngrok.dev/mcp |
| Jira | Trouble tickets and knowledge base, Atlassian-backed (alternative ITSM) | https://akuig-jira.ngrok.dev/mcp |
| ServiceNow | Trouble tickets, ServiceNow-backed (alternative ITSM) | https://akuig-servicenow.ngrok.dev/mcp |
The three ITSM servers (ITSM Local, Jira, ServiceNow) implement the same trouble-ticket interface and are interchangeable. Your agent code and prompts do not change when you swap between them. For most scenarios, ITSM Local is the smoothest. Try the others when you want to see the same workflow land in a different enterprise ticketing backend.
Connecting
All servers use HTTP streaming transport. In Claude Desktop, add them to your claude_desktop_config.json under mcpServers:
{
"mcpServers": {
"bss": { "url": "https://akuig-bss.ngrok.dev/mcp", "name": "BSS" },
"enm": { "url": "https://akuig-enm.ngrok.dev/mcp", "name": "ENM Network Manager" },
"itsm-local": { "url": "https://akuig-itsm-local.ngrok.dev/mcp", "name": "Trouble Tickets (Local)" },
"bare-metal": { "url": "https://akuig-bare-metal.ngrok.dev/mcp", "name": "Bare Metal & GPU" },
"jira": { "url": "https://akuig-jira.ngrok.dev/mcp", "name": "Jira Tickets & KB" },
"servicenow": { "url": "https://akuig-servicenow.ngrok.dev/mcp", "name": "ServiceNow Tickets" }
}
}Other MCP clients accept the same URLs. You do not need all six connected at once. BSS plus ENM plus one ITSM server is enough for most scenarios. Add Bare Metal for the GPU work.
Once connected, just talk to the agent in plain language. You do not need to know tool names or TMF numbers. The tool descriptions carry their own domain keywords so the agent finds the right one.
The network
The estate spans a national core across three main sites (Norvik, Springfield, Al Marsa) with three more fed from them (Shelbyville, Lishan, Eldby). It is a mix of residential fibre and cable customers and nine corporate accounts across enterprise, healthcare, utilities, retail, education, manufacturing, government, AI, and wholesale.
An interactive map of the topology, with pan, zoom, per-customer highlighting, and tooltips, is at:
https://www.akuig.com/network_topology.html
Open it in a browser alongside your agent conversation. When you inject a fault or trace a customer's tails, you can see exactly where in the network you are working.
Who is who
Residential customers sit in the 8452xxx range. Corporate accounts sit in the 9100xxx range, so you can tell segment at a glance. A few worth knowing:
| Customer ID | Name | Why it is interesting |
|---|---|---|
| 8452934 | Jane Doe | Clean residential anchor; fibre, plus a GPU cluster footprint. Good first customer to explore. |
| 8452937 | Bob Williams | Suspended for non-payment; cable modem locked. Good for lifecycle and collections. |
| 8452938 | Carol Brown | Sovereign AI anchor; H100 cluster in the Oslo DC. |
| 9100001 | Globex Industries | Platinum enterprise, diverse protected tails at HQ. The SLA outage story. |
| 9100002 | Springfield General Hospital | Platinum healthcare with a dedicated 5G slice. Priority restoration. |
| 9100004 | QwikMart Retail Group | Silver retail, HQ plus 12 stores. Carries a live billing dispute. |
| 9100005 | Aurora Cognition | Platinum AI; 100G wavelength to an Oslo GPU cluster, open expansion quote. |
| 9100007 | Barley & Sons Brewing | Gold manufacturing; has an order sitting installed but not yet activated. |
| 9100008 | Springfield City Council | Government; sovereign cloud with EU/EEA-only data residency. |
Scenarios to try
Each of these is a short conversation. Paste the prompts in order, or paraphrase them. The agent will choose the right tools. Everything is reversible; email demo@akuig.com for a reset.
1. Customer 360 across every silo
The cross-silo pitch in miniature. Pick a customer and pull their whole footprint from four separate systems in one conversation.
"Give me a full picture of customer 8452934: their BSS profile and products, the network equipment serving them, any open trouble tickets, and any infrastructure they have allocated."
The agent reaches into BSS, ENM, your ITSM, and Bare Metal, and stitches them together on the customer ID. Try it again with 9100001 (Globex) to see a corporate footprint spanning multiple sites.
2. End-to-end service provisioning
One conversation, four systems, a service brought to life.
"I want to sell fibre to a new address. Qualify the location, look up the customer, place a product order, and activate the service."
Watch the agent qualify the address, check the customer, raise the order, then activate in the network. Every step is a distinct TMF API and every step is logged.
3. Fault injection and impact analysis
See how a network fault ripples into customers, SLAs, and tickets.
"Inject a fault on SPFLD-OLT-01. Then tell me which customers are affected, what their SLA tiers are, and open a prioritised trouble ticket for the worst-hit ones."
"Now clear the alarm and confirm we are back to a clean baseline."
The agent correlates the network alarm against BSS customer records to rank impact by SLA tier, then raises tickets in your chosen ITSM. This is the workflow carriers care about most.
4. The enterprise SLA outage (the money demo)
Globex Industries (9100001) is platinum, with diverse protected tails at HQ. This shows why protection matters in real money terms.
"Check path diversity for customer 9100001."
"Inject a fibre cut on the A tail at Globex HQ. What is the SLA credit exposure right now?"
Because the traffic survives on the backup tail, exposure is zero. Now break the other leg:
"Cut the B tail as well. What is the exposure now?"
With both legs down, the agent shows a live per-hour credit exposure against the platinum SLA.
"Open a priority trouble ticket and clear both faults."
5. Order-to-activate with live inventory
Barley & Sons (9100007) has an order installed but not yet switched on.
"What is the status of Barley & Sons' open order? What is still outstanding?"
The agent finds the order with everything done except activation, and the new site's demarcation point installed but locked.
"Activate it, then confirm the site is live and show me the first invoice."
Activation orchestrates across silos: BSS completes the order and raises the pro-rated first invoice while ENM unlocks and enables the equipment and creates the customer link.
6. Billing dispute and revenue assurance
QwikMart (9100004) is disputing an invoice.
"Show me QwikMart's disputed June invoice, then compare the charges against their actual usage for the month."
The agent surfaces the invoice and finds a discrepancy where two stores were double-billed for their backup connectivity.
"Resolve the dispute with a credit adjustment and confirm the invoice is settled."
7. Sovereign GPU and AI infrastructure
Aurora Cognition (9100005) runs AI workloads on sovereign infrastructure with strict data residency.
"Show Aurora Cognition's infrastructure footprint and how it connects to the network."
"They have an open expansion quote. Show it, then check whether the GPU capacity they want is actually available in the right country."
This is the data-sovereignty story: GPU capacity tied to specific national data centres, with residency treated as a first-class constraint rather than an afterthought. You can also provision fresh capacity:
"Check H100 availability across the sovereign data centres, provision a cluster for customer 8452938, and assign network and storage."
8. Swap the ticketing backend
Run scenario 3 or 4 with ITSM Local. Then disconnect it, connect Jira or ServiceNow instead, and run the exact same prompts. The workflow and your phrasing do not change; only the backend the ticket lands in does. This is the point of a standards-based interface.
Tips
- You do not need to know tool names or TMF numbers. Describe what you want; the agent picks the tool.
- Keep the topology map open in a browser tab. It makes fault and diversity scenarios far more vivid.
- If the agent seems to have gone off track or a server looks unresponsive, start a fresh conversation before assuming something is broken.
- Every mutation is reversible. Explore freely.
- For a full reset to a pristine baseline (alarms cleared, disputes and locked orders restored), email demo@akuig.com.
A note on what this is showing
The headline is not any single scenario. It is that one agent, in one conversation, took governed and auditable actions across a customer system, a network system, a ticketing system, and an infrastructure system that in a real carrier would never speak to each other. That cross-silo orchestration, with a full audit trail and standards-based interfaces, is what Telepath AI provides.
Questions, or want the environment reset? demo@akuig.com.
Appendix: reference data
Residential customers (8452xxx)
The cross-silo key throughout is the customer ID.
| ID | Name | Status | Tier | City | Notes |
|---|---|---|---|---|---|
| 8452934 | Jane Doe | Active | - | Springfield | Primary anchor; fibre ONT; GPU cluster footprint (8x H100) |
| 8452935 | John Smith | Active | - | Springfield | Overdue balance; bare metal server allocated |
| 8452936 | Alice Johnson | Active | - | Springfield | Premium support; 8x A100 cluster |
| 8452937 | Bob Williams | Suspended | - | Springfield | Non-payment; cable modem locked and disabled |
| 8452938 | Carol Brown | Active | - | Springfield | Sovereign AI anchor; 8x H100 in Oslo DC |
| 8452939 | David Lee | Active | - | Shelbyville | Cable customer, second town |
| 8452940 | Ingrid Solberg | Active | Gold | Norvik | |
| 8452941 | Lars Eriksen | Active | Silver | Norvik | |
| 8452942 | Freya Lindqvist | Active | - | Norvik | |
| 8452943 | Astrid Nilsen | Active | - | Norvik | |
| 8452944 | Soren Dahl | Active | - | Norvik | Overdue invoice; useful for collections queries |
| 8452945 | Annika Holm | Active | Silver | Norvik | |
| 8452946 | Layla Haddad | Active | - | Springfield | |
| 8452947 | Omar Al-Farsi | Active | Silver | Springfield | |
| 8452948 | Yasmin Nasser | Active | - | Springfield | |
| 8452949 | Tariq Hassan | Active | - | Springfield | |
| 8452950 | Rania Khalil | Active | - | Shelbyville | |
| 8452951 | Karim Mansour | Active | Silver | Shelbyville | |
| 8452952 | Wei Zhang | Active | Gold | Shelbyville | |
| 8452953 | Mei Lin | Active | - | Al Marsa | |
| 8452954 | Li Wei | Active | - | Al Marsa | |
| 8452955 | Chen Jiahao | Active | - | Al Marsa | |
| 8452956 | Wang Fang | Active | Silver | Al Marsa | |
| 8452957 | Priya Sharma | Active | - | Lishan | |
| 8452958 | Yuki Tanaka | Active | - | Lishan | |
| 8452959 | Maria Santos | Active | Silver | Lishan |
Corporate customers (9100xxx)
Corporate accounts use the 9100xxx range so segment is visible at a glance.
| ID | Name | Segment | SLA | Sites | Products | MRC |
|---|---|---|---|---|---|---|
| 9100001 | Globex Industries | Enterprise | Platinum | HQ Norvik (diverse tails), branches Springfield and Shelbyville, campus Eldby | MPLS VPN (4 sites), 10G DIA at HQ | $15,300 |
| 9100002 | Springfield General Hospital | Healthcare | Platinum | Main campus Springfield (diverse), clinic Shelbyville | 10G DIA, dedicated 5G slice "hospital-priority", clinic 1G DIA | $11,200 |
| 9100003 | Springfield Municipal Power & Light | Utilities | Gold | Plant Springfield (diverse) | Private LTE, 2,000 IoT SIMs, 1G DIA | $6,400 |
| 9100004 | QwikMart Retail Group | Retail | Silver | HQ Springfield plus 12 stores (S01-S12) | SD-WAN overlay, GPON/DOCSIS underlay, 4G backup per store | $3,130 |
| 9100005 | Aurora Cognition AS | Enterprise AI | Platinum | Norvik cross-connect | 100G wavelength to Oslo DC, H100 cluster colocation | $14,000 |
| 9100006 | Norvik University | Education | Gold | Campus Norvik (diverse 100G tails) | 100G research wavelength, campus DIA | $9,800 |
| 9100007 | Barley & Sons Brewing | Manufacturing | Gold | Brewery Springfield; new site Al Marsa (pending activation) | 1G DIA plus SD-WAN | - |
| 9100008 | Springfield City Council | Government | Gold | Civic offices Springfield (diverse) | 1G diverse DIA, sovereign cloud with EU/EEA-only residency | $4,100 |
| 9100009 | Al Marsa Mobile | Wholesale MVNO | Gold | Interconnect at Al Marsa | Wholesale interconnect, national roaming, usage-based charges | $25,000+ |
Product catalogue
| Category | Offerings (monthly) |
|---|---|
| Internet | Fiber 500 $59.99, Fiber Gig $79.99, Fiber Pro 2G $129.99, Cable Max 400M $49.99, 5G Home $69.99 |
| TV | Basic TV $29.99, Premium TV $79.99, Stream TV $39.99 |
| Mobile | Family Mobile $120.00, Unlimited Mobile $65.00 |
| Bundles | Triple Play $99.99, Internet + TV $89.99, Smart Home $119.99, Everything $149.99 |
| Enterprise | DIA, MPLS VPN, SD-WAN, wavelength, private LTE, IoT, 5G network slices, GPU colocation cross-connects |
Underlying service specifications: fibre internet (500M/1G/2G), cable internet, 5G wireless, TV, and mobile, plus the enterprise services carried by the corporate accounts.
Sovereign data centres
| ID | Location | Tier | GPU inventory |
|---|---|---|---|
| DC-SG-01 | Jurong East, Singapore | Tier-4 | A100 / H100 |
| DC-SG-02 | Tuas, Singapore | Tier-3 | H100 |
| DC-NO-01 | Oslo, Norway | Tier-3 | H100 / H200 |
| DC-AU-01 | Sydney, Australia | Tier-3 | A100 |
| DC-SE-01 | Karlstad, Sweden | Tier-3 | H200 |
| DC-MY-01 | Johor Bahru, Malaysia | Tier-3 | H100 |
Server classes range from Standard Compute (64-core Xeon, 512GB) up to GPU Server H200 (128-core, 2TB, 8 GPUs).