Serveur MCP

Edgegap

dev.edgegap/mcp
Cloud et infrastructure Gaming Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Creates, versions, deploys, monitors, logs, and stops containerized multiplayer game servers on Edgegap's edge network.

edgegap_authorize_relay_user
Add a player to a relay session
Authorize one more player (by public IP) on an existing relay session, for a player joining after the session was created. Returns that player's authorization token.
Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['session_id', 'user_ip'], 'properties': {'user_ip': {'type': 'string', 'minLength': 3, 'description': 'Public IP of the joining player.'}, 'session_id': {'type': 'string'}}}
edgegap_build_matchmaker_config
Build a basic matchmaker configuration
Generate a ready-to-upload Edgegap matchmaker JSON configuration with one profile: team count and size, optional latency rule, and optional expansions that relax the rules the longer a player waits. Checks the referenced application version exists and has ports. Edgegap has no API for creating a matchmaker, so this tool does NOT create one: save the returned config to a file (e.g. matchmaker-config.json) and have the developer upload it on the Matchmaker page of the dashboard. The matchmaker starts an authoritative dedicated server for each match, which is the recommended setup for multiplayer games.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['profile_name', 'application', 'version', 'team_count', 'min_team_size', 'max_team_size'], 'properties': {'inspect': {'type': 'boolean', 'description': 'Expose the inspection API for debugging. Default true; turn off for production.'}, 'version': {'type': 'string', 'description': 'Version the matchmaker deploys.'}, 'expansions': {'type': 'array', 'items': {'type': 'object', 'required': ['after_seconds'], 'properties': {'after_seconds': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'min_team_size': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'max_latency_ms': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}}}, 'description': 'Rule relaxations after a player has waited this long, e.g. [{after_seconds: 30, min_team_size: 1}].'}, 'team_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Teams per match. 1 for free-for-all or co-op.'}, 'application': {'type': 'string', 'description': 'Application the matchmaker deploys.'}, 'profile_name': {'type': 'string', 'description': 'Profile clients will queue into, e.g. "casual-2v2".'}, 'max_team_size': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'min_team_size': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'max_latency_ms': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Adds a latency rule: drop players above this ping to the chosen region. Needs beacon pings from the client.'}, 'verify_version': {'type': 'boolean', 'description': 'Look up the application version first. Default true.'}, 'ticket_expiration': {'type': 'string', 'description': 'Default "5m".'}, 'latency_difference_ms': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Max ping spread between matched players. Default 100.'}}}
edgegap_create_app
Create an Edgegap application
Create a new application to hold game server versions. Only call this after edgegap_list_apps confirms no suitable application exists. Creating an application does not deploy anything — follow with edgegap_create_app_version.
Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 64, 'minLength': 3, 'description': 'Application name, 3-64 chars. Usually the game or project name.'}, 'is_active': {'type': 'boolean', 'description': 'Whether deployments are allowed. Default true.'}}}
edgegap_create_app_version
Create an application version
Register a container image as a deployable version of an application. The image must already be pushed to a registry that Edgegap can pull from (see edgegap_get_registry_credentials and edgegap_list_registry_tags). Resource units: 1024 cpu units = 1 vCPU; memory_mb must be at least 256 and at most double the cpu units. Set verify_image true on the first version so a bad image fails here rather than at deploy time. Avoid the "latest" docker tag — use a build ID so deployments are reproducible.
Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['application', 'name', 'docker_repository', 'docker_image', 'docker_tag', 'cpu_units', 'memory_mb', 'ports'], 'properties': {'env': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'value'], 'properties': {'key': {'type': 'string'}, 'value': {'type': 'string'}}}, 'description': 'Environment variables injected into the container.'}, 'name': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Version identifier, typically a build ID or timestamp.'}, 'ports': {'type': 'array', 'items': {'type': 'object', 'required': ['port', 'protocol'], 'properties': {'name': {'type': 'string', 'description': 'Label, e.g. "gameport".'}, 'port': {'type': 'integer', 'maximum': 59999, 'minimum': 1, 'description': 'Port the server listens on.'}, 'protocol': {'type': 'string', 'description': 'One of UDP, TCP, TCP/UDP, HTTP, HTTPS, WS, WSS. Most game servers use UDP.'}, 'to_check': {'type': 'boolean', 'description': 'Readiness check on this port. Default true.'}}}, 'minItems': 1, 'description': 'Ports to expose. At least one is required for players to connect.'}, 'cpu_units': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 256, 'description': 'vCPU units. 1024 = 1 vCPU.'}, 'memory_mb': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 256, 'description': 'Memory in MB. At most 2x cpu_units.'}, 'docker_tag': {'type': 'string', 'description': 'Image tag. Use a build ID, not "latest".'}, 'application': {'type': 'string', 'description': 'Existing application name.'}, 'docker_image': {'type': 'string', 'description': 'Namespaced image, e.g. "mystudio/game-server".'}, 'verify_image': {'type': 'boolean', 'description': 'Verify Edgegap can pull the image before accepting the version.'}, 'registry_token': {'type': 'string', 'description': 'Registry password or token.'}, 'docker_repository': {'type': 'string', 'description': 'Registry host, e.g. "docker.io" or "registry.edgegap.com".'}, 'registry_username': {'type': 'string', 'description': 'Registry username, for private images.'}, 'max_duration_minutes': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Auto-stop after this many minutes. Keeps test deployments from running up cost.'}}}
edgegap_create_relay_session
Create a relay session (host-client games only)
A relay is NOT a game server and is not the recommended default — for a multiplayer match, deploy an authoritative dedicated server with edgegap_deploy instead. A relay only forwards traffic between players while one player's game acts as host and owns the game state: the host can cheat and has a latency advantage, the host's PC and connection cap the match, and the match ends if the host quits. Only use this when the developer has chosen peer-to-peer/host-client, or the netcode is already a listen server and a dedicated server is not an option; if that has not been established, ask first. Never pick it only because it needs no server image. Creates an Edgegap relay session for every player's public IP, host first, waits until it is ready, and returns the relay address plus per-player authorization tokens for the relay transport. Relay sessions are billed while open: delete test sessions with edgegap_delete_relay_session when finished.
Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['user_ips'], 'properties': {'user_ips': {'type': 'array', 'items': {'type': 'string', 'minLength': 3}, 'minItems': 1, 'description': 'Public IP of each player, host first. Add late joiners with edgegap_authorize_relay_user.'}, 'webhook_url': {'type': 'string', 'format': 'uri', 'description': 'Called when the session is ready.'}, 'timeout_seconds': {'type': 'integer', 'maximum': 120, 'minimum': 5, 'description': 'Default 30.'}, 'wait_until_ready': {'type': 'boolean', 'description': 'Poll until the relay is assigned. Default true.'}}}
edgegap_delete_relay_session
Delete a relay session
Close one relay session. Connected players lose their relay connection. Delete every session you created for testing before ending your task.
Destructif Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['session_id'], 'properties': {'session_id': {'type': 'string'}}}
edgegap_deploy
Deploy a game server
Start one authoritative dedicated game server from an application version, placed near the players you specify. This is the recommended way to host a multiplayer match: the server owns the game state, so no player hosts it. Returns immediately with a request_id; the server is still starting and has no connection details yet. Follow this call with edgegap_wait_for_deployment to get the address players connect to. Always stop deployments you started for testing.
Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['application', 'version', 'users'], 'properties': {'env': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'value'], 'properties': {'key': {'type': 'string'}, 'value': {'type': 'string'}}}, 'description': 'Environment variables for this deployment only.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Tags for filtering later, e.g. ["agent-test"]. Recommended.'}, 'users': {'type': 'object', 'properties': {'ip_addresses': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Public IPv4/IPv6 addresses of the players. Edgegap places the server near them.'}, 'geo_coordinates': {'type': 'array', 'items': {'type': 'object', 'required': ['latitude', 'longitude'], 'properties': {'latitude': {'type': 'number'}, 'longitude': {'type': 'number'}}}, 'description': 'Latitude/longitude pairs, as an alternative to IP addresses.'}}, 'description': 'Where the players are. Exactly one of these two is required.'}, 'version': {'type': 'string', 'description': 'Version name within the application.'}, 'cpu_units': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 256, 'description': 'Override the version CPU.'}, 'memory_mb': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 256, 'description': 'Override the version memory.'}, 'application': {'type': 'string', 'description': 'Application name.'}}}
edgegap_generate_dockerfile
Generate a game server Dockerfile
Write a Dockerfile for this project's headless game server build, ready for Edgegap: linux/amd64 base, the build folder copied in, the binary made executable, the right headless flags (Unity -batchmode -nographics, Godot --headless), a non-root user where the engine needs it (Unreal refuses root), CRLF fixes for start scripts, and EXPOSE lines matching the ports. Call this when the project has no Dockerfile, before building anything. Look at the build output first so you can pass the real build folder, binary name and port; anything you omit is assumed and listed under assumptions, which you must confirm with the developer or the project files. Write the result to Dockerfile, then build. The output is checked against edgegap_validate_server_config before it is returned. Makes no API calls.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['engine'], 'properties': {'ports': {'type': 'array', 'items': {'type': 'object', 'required': ['port', 'protocol'], 'properties': {'name': {'type': 'string'}, 'port': {'type': 'integer', 'maximum': 59999, 'minimum': 1}, 'protocol': {'enum': ['UDP', 'TCP', 'TCP/UDP', 'HTTP', 'HTTPS', 'WS', 'WSS'], 'type': 'string'}}}, 'description': 'Ports the server listens on. Default: 7777, with the protocol the netcode uses (UDP if unknown).'}, 'engine': {'enum': ['unity', 'unreal', 'godot', 'other'], 'type': 'string', 'description': 'Game engine of the server build.'}, 'netcode': {'type': 'string', 'description': 'Networking transport, to pick the protocol. Known: mirror-kcp, kcp, mirror-telepathy, telepathy, mirror-simpleweb, simpleweb, websocket, fishnet-tugboat, tugboat, netcode-for-gameobjects, ngo, unity-transport, utp, photon-fusion, litenetlib, enet, unreal-netdriver, godot-enet, godot-websocket.'}, 'base_image': {'type': 'string', 'description': 'Default "ubuntu:22.04".'}, 'build_path': {'type': 'string', 'description': 'Server build folder, relative to where docker build runs. Defaults: unity "Builds/EdgegapServer", unreal "." (run from inside the packaged LinuxServer folder), godot "build".'}, 'executable': {'type': 'string', 'description': 'File name of the server binary or start script inside build_path. Defaults: unity "ServerBuild", unreal "StartServer.sh", godot "server.x86_64". Required for "other".'}, 'launch_args': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Extra server arguments, one per entry, e.g. ["-log", "-port=7777"].'}}}
edgegap_get_deployment
Get deployment status
Read the current status of one deployment, including connection address and ports once it is ready. For a deployment you just created, prefer edgegap_wait_for_deployment — it polls for you instead of making you call this in a loop.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string', 'description': 'The request_id returned by edgegap_deploy.'}}}
edgegap_get_deployment_logs
Get container logs for a deployment
Retrieve stdout/stderr and crash output for a deployment. Call this whenever a deployment errors or a server exits unexpectedly — the crash exit code usually identifies the problem faster than redeploying does. Logs for stopped deployments are only retained if Endpoint Storage was configured on the version beforehand.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string', 'description': 'The request_id of the deployment.'}, 'max_characters': {'type': 'integer', 'maximum': 50000, 'minimum': 500, 'description': 'Truncate logs to this length, keeping the tail. Default 8000.'}}}
edgegap_get_registry_credentials
Get Edgegap container registry push credentials
Return the registry URL, project, username and token for this organization's private Edgegap container registry (registry.edgegap.com), plus the exact docker login, build and push commands for your image. Use this when the server image is not in a registry yet — no Docker Hub account needed. Provisions the registry project on first use. The token is registry-scoped (push/pull images in this project), not the org API token: pass it to docker login via --password-stdin, never as a command-line argument, and do not write it into files. Call edgegap_validate_server_config before building.
Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'tag': {'type': 'string', 'description': 'Unique build tag for the commands, e.g. a build ID. Never "latest".'}, 'image_name': {'type': 'string', 'pattern': '^[a-z0-9]+([._-][a-z0-9]+)*$', 'description': 'Image name without project or tag, e.g. "my-game-server". Used to build the commands.'}}}
edgegap_get_relay_session
Get a relay session
Read one relay session: whether it is ready, the relay address and ports, and each authorized player with their authorization token. edgegap_create_relay_session already waits for readiness; use this to re-read a session or one created with wait_until_ready false.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['session_id'], 'properties': {'session_id': {'type': 'string', 'description': 'Returned by edgegap_create_relay_session.'}}}
edgegap_list_apps
List Edgegap applications
List the applications in the Edgegap organization. Start here before creating or deploying anything, so you reuse an existing application instead of making a duplicate. An "application" groups versions of one game server.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Results per page. Default 50.'}}}
edgegap_list_app_versions
List versions of an application
List the versions under an application, with their container image and resource settings. Use this to find the version name to deploy, or to copy settings from a working version when creating a new one.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['application'], 'properties': {'application': {'type': 'string', 'description': 'Application name, as returned by edgegap_list_apps.'}}}
edgegap_list_deployments
List running deployments
List active deployments, optionally filtered and sorted. Use this to find deployments left running from earlier sessions before starting new ones — orphaned servers cost money. Filter by status, application, version, tags, request_id, created_at, fleet_name or host_name, e.g. [{field:"application",operator:"eq",value:"my-game"},{field:"status",operator:"eq",value:"ready"}]. Operators: eq and neq on every field except created_at (eq, gte, lte); in and nin with an array value on request_id, tags, application, version, fleet_name, host_name; ilike with % wildcards on fleet_name and host_name. At most one filter per field. Sort by created_at or available_session_sockets.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Default 50.'}, 'filters': {'type': 'array', 'items': {'type': 'object', 'required': ['field', 'operator', 'value'], 'properties': {'field': {'enum': ['status', 'request_id', 'tags', 'created_at', 'application', 'version', 'fleet_name', 'host_name'], 'type': 'string'}, 'value': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'A string, or an array of strings for in/nin. created_at is ISO 8601, e.g. "2026-09-30T00:00:00Z".'}, 'operator': {'enum': ['eq', 'neq', 'in', 'nin', 'gte', 'lte', 'ilike'], 'type': 'string'}}}, 'description': 'Omit for all deployments.'}, 'order_by': {'type': 'array', 'items': {'type': 'object', 'required': ['field', 'order'], 'properties': {'field': {'enum': ['created_at', 'available_session_sockets'], 'type': 'string'}, 'order': {'enum': ['asc', 'desc'], 'type': 'string'}}}, 'description': 'e.g. [{field:"created_at",order:"asc"}] for oldest first.'}}}
edgegap_list_registry_tags
List image tags in the Edgegap registry
List the tags pushed for one image in this organization's Edgegap container registry, with push time and size. Call it after docker push to confirm the tag landed before edgegap_create_app_version, which otherwise fails later with an image-pull error.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['image_name'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Default 20.'}, 'image_name': {'type': 'string', 'description': '"<project>/<image>", e.g. "my-org-cv2l3w3vy6fg/my-game-server". Project comes from edgegap_get_registry_credentials.'}}}
edgegap_stop_deployment
Stop a deployment
Gracefully stop one deployment by request_id, sending SIGTERM to the container. Stop every deployment you started for testing before ending your task. This tool stops exactly one deployment; bulk stop is deliberately not exposed.
Destructif Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string', 'description': 'The request_id of the deployment to stop.'}}}
edgegap_validate_server_config
Validate a game server Dockerfile and port config
Check a game server Dockerfile and the ports/resources you intend to register against what Edgegap requires, BEFORE building and pushing. Catches the failures that otherwise only show up after a build, push, version and deploy: ARM or Windows images (Edgegap runs linux/amd64), Unreal running as root, missing Unity -batchmode -nographics, a server bound to localhost, EXPOSE ports that do not match the version ports, a protocol that does not match the netcode transport, the "latest" tag, and bad CPU/memory ratios. Pass the Dockerfile text (read it from disk first). If there is no Dockerfile yet, call edgegap_generate_dockerfile instead. Makes no API calls.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'ports': {'type': 'array', 'items': {'type': 'object', 'required': ['port', 'protocol'], 'properties': {'name': {'type': 'string'}, 'port': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'protocol': {'type': 'string'}}}, 'description': 'Ports you plan to pass to edgegap_create_app_version.'}, 'engine': {'enum': ['unity', 'unreal', 'godot', 'other'], 'type': 'string', 'description': 'Game engine. Detected from the Dockerfile when omitted.'}, 'netcode': {'type': 'string', 'description': 'Networking transport, to check the port protocol. Known: mirror-kcp, kcp, mirror-telepathy, telepathy, mirror-simpleweb, simpleweb, websocket, fishnet-tugboat, tugboat, netcode-for-gameobjects, ngo, unity-transport, utp, photon-fusion, litenetlib, enet, unreal-netdriver, godot-enet, godot-websocket.'}, 'cpu_units': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'memory_mb': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'docker_tag': {'type': 'string'}, 'dockerfile': {'type': 'string', 'description': 'Full text of the Dockerfile.'}, 'docker_image': {'type': 'string'}, 'docker_repository': {'type': 'string'}}}
edgegap_wait_for_deployment
Wait for a deployment to become ready
Poll a deployment until it is ready, errors, or the timeout expires, then return the connection details. This is the tool to call right after edgegap_deploy. Do not build your own polling loop — this handles backoff and reports the container error detail if the server fails to start.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string', 'description': 'The request_id returned by edgegap_deploy.'}, 'timeout_seconds': {'type': 'integer', 'maximum': 600, 'minimum': 5, 'description': 'How long to wait before giving up. Default 180.'}}}
Ajouté
edgegap_build_matchmaker_config
3 October 2026 02:51
Ajouté
edgegap_delete_relay_session
3 October 2026 02:51
Ajouté
edgegap_authorize_relay_user
3 October 2026 02:51
Ajouté
edgegap_get_relay_session
3 October 2026 02:51
Ajouté
edgegap_create_relay_session
3 October 2026 02:51
Ajouté
edgegap_list_registry_tags
3 October 2026 02:51
Ajouté
edgegap_get_registry_credentials
3 October 2026 02:51
Ajouté
edgegap_validate_server_config
3 October 2026 02:51
Ajouté
edgegap_generate_dockerfile
3 October 2026 02:51
Modifié
edgegap_list_deployments
3 October 2026 02:51
Modifié
edgegap_deploy
3 October 2026 02:51
Modifié
edgegap_create_app_version
3 October 2026 02:51
Ajouté
edgegap_get_deployment_logs
17 September 2026 12:39
Ajouté
edgegap_stop_deployment
17 September 2026 12:39
Ajouté
edgegap_list_deployments
17 September 2026 12:39
Ajouté
edgegap_wait_for_deployment
17 September 2026 12:39
Ajouté
edgegap_get_deployment
17 September 2026 12:39
Ajouté
edgegap_deploy
17 September 2026 12:39
Ajouté
edgegap_create_app_version
17 September 2026 12:39
Ajouté
edgegap_list_app_versions
17 September 2026 12:39
Ajouté
edgegap_create_app
17 September 2026 12:39
Ajouté
edgegap_list_apps
17 September 2026 12:39