Nakama (Heroic Labs)

Open-source game server by Heroic Labs providing real-time multiplayer, social features, leaderboards, and matchmaking — deployable self-hosted or via Heroic Cloud managed service.

Evaluated Mar 07, 2026 (0d ago) vcurrent
Homepage ↗ Repo ↗ Other gaming open-source self-hosted grpc websocket leaderboards multiplayer social-graph
⚙ Agent Friendliness
55
/ 100
Can an agent use this?
🔒 Security
79
/ 100
Is it safe for agents?
⚡ Reliability
79
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
--
Documentation
80
Error Messages
75
Auth Simplicity
70
Rate Limits
65

🔒 Security

TLS Enforcement
90
Auth Strength
80
Scope Granularity
70
Dep. Hygiene
82
Secret Handling
75

Self-hosted deployments place full security responsibility on the operator — TLS, firewall rules, and key rotation are not enforced by default. Server key is a single shared secret. Heroic Cloud provides managed TLS and network isolation.

⚡ Reliability

Uptime/SLA
75
Version Stability
82
Breaking Changes
78
Error Recovery
80
AF Security Reliability

Best When

Building a real-time multiplayer game where you need full control over server logic and data, with the option to self-host on your own infrastructure.

Avoid When

Your team lacks backend engineering capacity to operate and scale a stateful game server, or you need a fully managed zero-ops solution.

Use Cases

  • Implement real-time authoritative game state sync between players using Nakama's relayed or authoritative match handler
  • Build social friend graphs with presence notifications so agents can trigger events when friends come online
  • Run custom server-side game logic via Lua or TypeScript runtime modules without managing a separate server
  • Automate leaderboard resets and reward distribution using scheduled server-side functions (cron-style runtime calls)
  • Manage in-game economy (wallets, item grants, store purchases) programmatically via the REST or gRPC API

Not For

  • Teams without DevOps capacity for self-hosted Kubernetes or Docker deployment — managed Heroic Cloud adds cost
  • Purely mobile attribution or analytics — Nakama is a game server, not an analytics platform
  • Games requiring a purely serverless architecture — Nakama requires a persistent stateful server process

Interface

REST API
Yes
GraphQL
No
gRPC
Yes
MCP Server
No
SDK
Yes
Webhooks
No

Authentication

Methods: api_key session_token basic_auth
OAuth: No Scopes: No

Server key (static) used for server-to-server calls. Players authenticate via device ID, email, social providers (Google, Apple, Facebook), or custom tokens and receive a session token. HTTP key (separate from server key) required for REST API access to admin console endpoints.

Pricing

Model: open_source
Free tier: Yes
Requires CC: No

Self-hosted costs are infrastructure only. Heroic Cloud pricing scales with concurrent users (CCU) rather than MAU.

Agent Metadata

Pagination
cursor
Idempotent
Partial
Retry Guidance
Not documented

Known Gotchas

  • gRPC and REST APIs are not 1:1 feature-equivalent — some admin features are REST-only via the console API
  • Runtime modules (Lua/TypeScript) are loaded at server startup; deploying new logic requires server restart unless using Heroic Cloud hot reload
  • Session tokens expire (default 60s for refresh token window) and must be refreshed; agents that don't handle token refresh will get 401s
  • Self-hosted deployments require CockroachDB or PostgreSQL — agents connecting directly to the database bypass all Nakama access controls
  • Match presence events are delivered over WebSocket only — REST polling cannot subscribe to real-time match state changes

Alternatives

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for Nakama (Heroic Labs).

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

$3

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

Scores are editorial opinions as of 2026-03-07.

6470
Packages Evaluated
26150
Need Evaluation
173
Need Re-evaluation
Community Powered