ClaudIA 5GC
Read the docs
What it isAsk your coreSee it runArchitectureContactGitHub

The 5G core your AI agent can operate.

  • +30 MCP tools for AI agents
  • Ask in plain language, the agent calls the core
  • Built for private 5G networks
  • 3GPP Release 17, standard interfaces end to end

Read the docsAsk your core

Runs as containers on a single machine

signalling replay · Initial RegistrationIllustrative replay, not live traffic.
ClaudIA 5GC signaling theaterNetwork graph of the UE, gNB, thirteen core network functions, the data network and the MCP server, replaying documented 3GPP procedures. A step list for each procedure follows the graph.SNAPRGUuN2 (NGAP + N1 NAS)N3N6N11N4N12N13N8N10N35N36N7N15N22N20NLsNbsfNbsfN30toolingtoolingNnrfNnrfNnrfNnrfNnrfNnrfNnrfNnrfNnrfNnrfNnrfMCPUEgNBAMFNSSFSMSFLMFNRFSMFUPFAUSFUDMUDRPCFBSFNEFDN

  • SBI
  • NGAP
  • NAS-5GS
  • PFCP
  • NRPPa
  • GTP-U
  • Control plane
  • User plane
  • Tooling (MCP)

Boot: Every NF registers with the NRF, then the gNB sets up its NG interface with the AMF.

  1. Nnrf_NFManagement_NFRegister, AMF to NRF over Nnrf, TS 29.510 §5.2.2.2
  2. Nnrf_NFManagement_NFRegister, AUSF to NRF over Nnrf, TS 29.510 §5.2.2.2
  3. Nnrf_NFManagement_NFRegister, UDM to NRF over Nnrf, TS 29.510 §5.2.2.2
  4. Nnrf_NFManagement_NFRegister, UDR to NRF over Nnrf, TS 29.510 §5.2.2.2
  5. Nnrf_NFManagement_NFRegister, SMF to NRF over Nnrf, TS 29.510 §5.2.2.2
  6. Nnrf_NFManagement_NFRegister, PCF to NRF over Nnrf, TS 29.510 §5.2.2.2
  7. Nnrf_NFManagement_NFRegister, NSSF to NRF over Nnrf, TS 29.510 §5.2.2.2
  8. Nnrf_NFManagement_NFRegister, SMSF to NRF over Nnrf, TS 29.510 §5.2.2.2
  9. Nnrf_NFManagement_NFRegister, BSF to NRF over Nnrf, TS 29.510 §5.2.2.2
  10. Nnrf_NFManagement_NFRegister, NEF to NRF over Nnrf, TS 29.510 §5.2.2.2
  11. Nnrf_NFManagement_NFRegister, LMF to NRF over Nnrf, TS 29.510 §5.2.2.2
  12. NGSetupRequest, gNB to AMF over N2, TS 38.413 §8.7.1
  13. NGSetupResponse, AMF to gNB over N2, TS 38.413 §8.7.1

Initial Registration: UE-initiated registration with 5G-AKA authentication, security mode, subscription and policy retrieval.

  1. InitialUEMessage[RegistrationRequest], gNB to AMF over N2, TS 38.413 §8.6.1; TS 24.501 §8.2.6; TS 23.502 §4.2.2.2.2 step 3
  2. Nausf_UEAuthentication_Authenticate, AMF to AUSF over N12, TS 29.509 §5.2.2.2; TS 23.502 §4.2.2.2.2 step 9
  3. Nudm_UEAuthentication_Get, AUSF to UDM over N13, TS 29.503 §5.4.2.2
  4. Nudr_DataRepository Query (AuthenticationSubscription), UDM to UDR over N35, TS 29.504 §5.2.2.2
  5. AuthenticationRequest, AMF to UE over N1, TS 24.501 §8.2.1
  6. AuthenticationResponse, UE to AMF over N1, TS 24.501 §8.2.2
  7. SecurityModeCommand, AMF to UE over N1, TS 24.501 §8.2.25
  8. SecurityModeComplete, UE to AMF over N1, TS 24.501 §8.2.26
  9. Nudm_UECM_Registration, AMF to UDM over N8, TS 29.503 §5.3.2.2.2; TS 23.502 §4.2.2.2.2 step 14
  10. Nudm_SDM_Get, AMF to UDM over N8, TS 29.503 §5.2.2.2
  11. Nnssf_NSSelection_Get, AMF to NSSF over N22, TS 29.531 §5.2.2.2
  12. Npcf_AMPolicyControl_Create, AMF to PCF over N15, TS 29.507 §4.2.2; TS 23.502 §4.2.2.2.2 step 16
  13. InitialContextSetupRequest[RegistrationAccept], AMF to gNB over N2, TS 38.413 §8.3.1; TS 24.501 §8.2.7
  14. RegistrationComplete, UE to AMF over N1, TS 24.501 §8.2.8

PDU Session Establishment: UE-requested PDU session: SMF selects policy, programs the UPF over PFCP, and the RAN sets up the user plane.

  1. ULNASTransport[PDUSessionEstablishmentRequest], UE to AMF over N1, TS 24.501 §8.2.10; TS 23.502 §4.3.2.2.1 step 1
  2. Nsmf_PDUSession_CreateSMContext, AMF to SMF over N11, TS 29.502 §5.2.2.2; TS 23.502 §4.3.2.2.1 step 3
  3. Nudm_SDM_Get (sm-data), SMF to UDM over N10, TS 29.503 §5.2.2.2; TS 23.502 §4.3.2.2.1 step 4
  4. Npcf_SMPolicyControl_Create, SMF to PCF over N7, TS 29.512 §4.2.2.2; TS 23.502 §4.3.2.2.1 step 7
  5. PFCP Session Establishment Request, SMF to UPF over N4, TS 29.244 §7.5.2; TS 23.502 §4.3.2.2.1 step 10
  6. PFCP Session Establishment Response, UPF to SMF over N4, TS 29.244 §7.5.3
  7. Namf_Communication_N1N2MessageTransfer, SMF to AMF over N11, TS 29.518 Namf_Communication N1N2MessageTransfer; TS 23.502 §4.3.2.2.1 step 11
  8. PDUSessionResourceSetupRequest, AMF to gNB over N2, TS 38.413 §8.2.1; TS 23.502 §4.3.2.2.1 step 12
  9. PDUSessionResourceSetupResponse, gNB to AMF over N2, TS 38.413 §8.2.1
  10. Nsmf_PDUSession_UpdateSMContext, AMF to SMF over N11, TS 29.502 §5.2.2.3; TS 23.502 §4.3.2.2.1 step 15
  11. PFCP Session Modification Request, SMF to UPF over N4, TS 29.244 §7.5.4; TS 23.502 §4.3.2.2.1 step 16a
  12. GTP-U user-plane traffic, gNB to DN over N3/N6, TS 29.281 §5

Location: Network-side positioning: Cell-ID via NGAP location reporting, then an NRPPa E-CID measurement round.

  1. Namf_Location_ProvideLocationInfo, LMF to AMF over NLs, TS 29.518 Namf_Location (LMF as consumer is project-specific); TS 23.273 §6.2
  2. LocationReportingControl, AMF to gNB over N2, TS 38.413 §8.12.1
  3. LocationReport, gNB to AMF over N2, TS 38.413 §8.12.3
  4. Namf_Location LocationData (200 OK), AMF to LMF over NLs, TS 29.518 Namf_Location
  5. PositioningInformationRequest, LMF to gNB over N2, TS 38.455 Positioning Information Exchange; TS 23.273 §6.2.9
  6. PositioningInformationResponse, gNB to LMF over N2, TS 38.455 Positioning Information Exchange
  7. E-CIDMeasurementInitiationRequest, LMF to gNB over N2, TS 38.455 §8.2.1
  8. E-CIDMeasurementReport, gNB to LMF over N2, TS 38.455 §8.2.3

What it is

A 5G core for private networks, built to be understood

ClaudIA 5GC is a complete 5G Standalone core designed for private 5G networks. It brings together 13 network functions to 3GPP Release 17 in one place.

It runs as containers on a single machine and ships with a management portal and an MCP server, so people and AI agents can inspect and operate it.

AI-native

A Model Context Protocol server exposes NF discovery, UE state, NAS decoding, traces, metrics and QoS controls as tools. The project itself is built with an agent-driven workflow.

MCP · +30 tools

Cloud-native

Each network function is its own container with its own health, metrics and traces. Core state lives in PostgreSQL and Redis.

1 NF = 1 container

Spec-conformant

Compliant with 3GPP Release 17 today, with Release 18 support on the way, so your private 5G network is built on current standards.

Rel-17 today · Rel-18 soon

MCP · tooling plane

Ask your core

An AI agent inspects and operates the core through its MCP tools. Watch a conversation unfold, or pick a question.

Generic agent terminal. Conversations are scripted and synthetic; tool names are the real MCP tools in mcp/.

Which NFs are up?

Prompt: Which NFs are up?

Tools called: nf_list → nf_status

Answer: All 13 network functions are registered with the NRF (demo values). NF Status AMF, SMF, UPF, NRF REGISTERED AUSF, UDM, UDR, PCF REGISTERED NSSF, SMSF, BSF, NEF, LMF REGISTERED The AMF heartbeat is healthy at a 10 s interval (demo).

Why did a UE fail to register?

Prompt: Why did UE-2 fail to register?

Tools called: ue_list → gmm_state_get → trace_query → nas_decode

Answer: UE-2’s Registration was rejected with 5GMM cause #62 — No network slices available. The slice it requested is not in the subscription, so the AMF could not build an Allowed NSSAI. Fix: add the S-NSSAI to the subscriber’s subscribed NSSAI, or have the UE request a slice it is subscribed to (illustrative demo scenario).

Show me the PDU session QoS

Prompt: Show me the PDU session QoS for UE-1

Tools called: pdu_session_list → pdu_session_qos_get → subscription_qos_get

Answer: UE-1 has PDU session 1 on DNN internet, S-NSSAI 1/000001 (demo values). Item Active Subscribed 5QI 9 9 Session-AMBR UL/DL 100 / 200 Mbps 100 / 200 Mbps QoS flow QFI 1 uses the default non-GBR profile; active values match the subscription.

How healthy is the core right now?

Prompt: How healthy is the core right now?

Tools called: kpi_snapshot → alert_list

Answer: The core looks healthy (demo values). KPI Value Registration success 99.2 % PDU session success 98.7 % Active UEs / sessions 4 / 4 No alerts are firing.

Management portal

See it run

Dashboard, subscribers, sessions, network slices and QoS. These loops were recorded from a local test lab with synthetic subscribers.

Live KPIsRegistration & PDU success rateNF health via NRF
  • Six KPI cards: NFs online, subscribers, active PDU sessions, NRF registrations and 5-minute success rates.
  • One card per network function, showing NRF registration, health and metrics status.
  • The UPF card shows NRF and health as unavailable: the UPF does not register with the NRF in this lab.

Synthetic subscribers. Identifiers are masked and addresses are documentation addresses.

13 network functions · 24 documented procedures

Architecture

A service-based core over mutual TLS and HTTP/2.

Control plane

User plane

AI & management

Plus Grafana · Prometheus · Loki · Jaeger · PostgreSQL · Redis

Architecture overview →

Quick start

Run it on your machine

You need Docker Engine 24+ with Compose v2, GNU Make and Node 18+.

  1. Clone the repository

    git clone https://github.com/francurieses/claudia-5gc && cd claudia-5gc

  2. Generate the dev PKI and start everything

    13 NFs, observability, the portal and four simulated multi-slice UEs

    make pki && make 5gcsa

  3. Open the portal and Grafana

    Portal on port 8080, Grafana on port 3000

    http://localhost:8080http://localhost:3000

Full getting-started guide →

Use it & contact

Free to use. Help when you need it.

Everything is open on GitHub. For integration, interoperability work or custom deployments, get in touch.

Specialized support

Get help with your project

  • Integration and deployment
  • Procedure and interoperability work
  • Tailored to your project

Email meLinkedInGitHub