--- title: NationsGlory API Integration on Truto slug: nationsglory category: Fitness canonical: "https://truto.one/integrations/detail/nationsglory/" --- # NationsGlory API Integration on Truto **Category:** Fitness **Status:** Beta ## MCP-ready AI tools Truto exposes 34 tools for NationsGlory that AI agents can call directly. - **list_all_nations_glory_playercount** — Get the current player count on nationsglory. Returns: count. - **list_all_nations_glory_country** — List all countries available on a nationsglory server. Returns: id. Required: server. - **get_single_nations_glory_country_by_id** — Get a single nationsglory country by its slug identifier on a given server. Returns: id. Required: server, id. - **list_all_nations_glory_mmr** — List MMR (Matchmaking Rating) records from the NationsGlory public API. Returns a 200 response with rating data; the upstream source does not enumerate response fields. Optional: server to target a specific NationsGlory server. - **list_all_nations_glory_notations** — List nationsglory notations for a specified week, country, and server. Returns notation records including id. All parameters are optional — week defaults to 2801, country defaults to france, and server defaults to blue. - **create_a_nations_glory_nabot_message** — Send a message to Nabot, the NationsGlory AI assistant, and receive its reply. Returns: message. Optionally supply session_uid to persist conversation memory across requests; if omitted, message defaults to "Bonjour comment ça va ?". - **create_a_nations_glory_nabot_session** — Create a new NationsGlory Nabot session by calling the createSession endpoint. Returns a session object; the specific response fields are not enumerated in the available source documentation (source page expired with no example payload or field tables). - **list_all_nations_glory_ngisland** — List nationsglory NGIslands ordered by online members. Returns: id, message. The full response field set is not publicly documented in the nationsglory API reference. - **list_all_nations_glory_oauth_token** — Validate a nationsglory OAuth access token against the API. Returns a 200 status response on a valid token or 400 on failure; the response body fields are not enumerated in the upstream source documentation. Required: access_token, client_secret. - **create_a_nations_glory_oauth_service** — Create a new OAuth service in NationsGlory for the authenticated API key account. Only one service is allowed per API key. Returns: client_id, secret_id. - **delete_a_nations_glory_oauth_service_by_id** — Delete the OAuth service associated with your NationsGlory API key. This permanently removes the service tied to the account. Returns an empty 200 response on success. - **update_a_nations_glory_oauth_service_by_id** — Update the OAuth service associated with your NationsGlory API key. Allows changing the service name, redirect URI, and support contact email. Returns: client_id, secret_id. - **list_all_nations_glory_hdv** — List auction house (HDV) items for a NationsGlory game server. The response structure is not enumerated in the available source documentation. Required: server. - **list_all_nations_glory_planning** — List NationsGlory planning events filtered by server, month, and year. Returns planning event records; the NationsGlory API does not enumerate the response field schema in its documentation. - **list_all_nations_glory_user** — List nationsglory users. Returns: username. - **get_single_nations_glory_user_by_id** — Get a nationsglory user by username. Returns: username. Required: id. - **list_all_nations_glory_webhook** — List all webhooks registered in nationsglory. Returns: url, eventType. - **get_single_nations_glory_webhook_by_id** — Get a single nationsglory webhook by id. Returns: url, eventType. Required: id. - **create_a_nations_glory_webhook** — Register a new webhook in nationsglory to receive country event notifications. Returns: url, eventType. - **delete_a_nations_glory_webhook_by_id** — Delete a nationsglory webhook by id. Returns: url, eventType. Required: id. - **create_a_nations_glory_nabot_message** — Send a message to the NationsGlory Nabot chatbot and receive a reply (deprecated endpoint). Returns: message. No parameters are required; message defaults to "Bonjour comment ça va ?". Note: this endpoint lives under the /deprecated/ path. - **create_a_nations_glory_nabot_session** — Create a NaBot session in nationsglory. This endpoint is marked as deprecated. No required parameters. The response body fields are not documented in the available source materials. - **list_all_nations_glory_ngislands** — List NG islands in nationsglory via the deprecated ngisland list endpoint. Returns paginated ngisland records including id. This endpoint is deprecated; the upstream source does not document the full response field set. - **list_all_nations_glory_oauth_tokens** — Validate a NationsGlory OAuth token by checking an access_token against its associated client_secret. This is a deprecated endpoint. Required: access_token, client_secret. - **create_a_nations_glory_oauth_service** — Create a new OAuth service in nationsglory (deprecated endpoint). Returns the client_id and secret needed for OAuth flows — copy these immediately as they are not shown again. Limited to one service per API key. - **delete_a_nations_glory_oauth_service_by_id** — Delete the OAuth service associated with the current API key in nationsglory (deprecated endpoint). Returns an empty 204 response on success. - **update_a_nations_glory_oauth_service_by_id** — Update the OAuth service associated with the current API key in nationsglory (deprecated endpoint). Returns the updated service object including client_id, name, redirect_uri, and contact. - **get_single_nations_glory_user_by_id** — Get a NationsGlory user profile by id from the deprecated user endpoint. This endpoint is deprecated and the upstream source documents no response fields beyond the queried username. Returns: username. Required: id. - **list_all_nations_glory_webhooks** — List all registered webhook endpoints in nationsglory (deprecated endpoint). Returns: url, eventType. - **get_single_nations_glory_webhook_by_id** — Get a single nationsglory webhook registration by id (deprecated endpoint). Returns: url, eventType. Required: id. - **create_a_nations_glory_webhook** — Register a new webhook in nationsglory to receive country event notifications (deprecated endpoint). Returns: url, eventType. Both url and eventType have documented defaults and are optional. - **delete_a_nations_glory_webhook_by_id** — Remove a nationsglory webhook registration by id (deprecated endpoint). Returns an empty 204 response on success. Required: id. - **list_all_nations_glory_countries** — List all countries on a nationsglory server. Returns: id. Required: server. - **get_single_nations_glory_country_by_id** — Get a single nationsglory country by its identifier on a specified server. Returns: id. Required: server, id. ## How it works 1. **Link your customer's NationsGlory account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach NationsGlory.** The Proxy API is a 1-to-1 mapping of the NationsGlory API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Native identity verification for gaming community platforms** — Community and chat SaaS products can let end users link their NationsGlory account via OAuth, then gate features based on in-game country membership or user status. This removes the need to build and maintain a Minecraft-specific auth flow in-house. - **Real-time in-game event alerts for community tools** — SaaS platforms that push notifications to Discord, Slack, or email can subscribe to NationsGlory webhooks and forward in-game events (attacks, diplomatic changes, planning updates) to their users. This turns a passive community tool into a live operations center for players. - **Virtual economy analytics and price monitoring** — Analytics and trading SaaS products can ingest NationsGlory's auction house (HDV) data to power dashboards, price history charts, and threshold-based alerts. It lets them offer a premium data layer to power players without scraping the game directly. - **Competitive leaderboards and tournament orchestration** — Esports and stat-tracking platforms can pull MMR and country notations to build cross-server rankings, seed brackets, or verify eligibility for tournaments. Truto handles auth and pagination so the SaaS focuses on the ranking logic. - **AI-assisted moderation and support for gaming forums** — Moderation and helpdesk SaaS tools can route game-specific questions from their UI into NationsGlory's NaBot and return authoritative answers about rules and lore. This gives forum operators accurate, in-context responses without training their own model on server data. ## What you can build - **NationsGlory OAuth-based sign-in** — Ship a 'Connect NationsGlory' button that provisions an OAuth service and exchanges tokens so your users authenticate with their in-game identity. - **Country roster dashboards** — Pull country metadata and member lists to render a private dashboard for each nation's leadership, refreshed on demand. - **Live event webhook router** — Register NationsGlory webhooks on behalf of your users and fan out in-game events to Discord, Slack, SMS, or your own notification service. - **HDV price watcher and market feed** — Poll the auction house endpoint to build a searchable market history, watchlists, and threshold alerts for rare items across servers. - **MMR-driven leaderboards and bracket seeding** — Sync MMR data into your tournament or stat-tracker product to auto-generate leaderboards and seed competitive brackets by rating. - **Embedded NaBot support widget** — Create NaBot sessions and post messages from inside your product to answer server-specific questions with game-accurate responses. ## FAQs ### How do end users authenticate their NationsGlory account? NationsGlory uses OAuth. Through Truto, you can create, update, and delete OAuth service configurations and list issued OAuth tokens, so your users connect their account with a standard OAuth consent flow without you handling token storage or refresh. ### How do we receive real-time in-game events? NationsGlory supports webhooks. You can create, list, retrieve, and delete webhooks through Truto to subscribe to server-side events and forward them into your product's own event pipeline. ### What in-game data can we read via the integration? Available reads include countries and single country lookups, users and single user lookups, player counts, MMR, notations, the HDV auction house, planning (event calendar), NG islands, and OAuth tokens. All are exposed as list or get operations through Truto. ### Can we write data back to NationsGlory? Write operations are currently limited to creating OAuth services, webhooks, and NaBot sessions and messages. Country, user, MMR, HDV, and planning data are read-only through the current tool set. ### How fresh is the data — is it streamed or polled? Event-style data (attacks, diplomatic changes, planning updates) is delivered via webhooks in near real time. Reference data like HDV listings, MMR, country standings, and player counts is retrieved on demand via list endpoints, so freshness depends on your polling cadence. ### Can we integrate NationsGlory's AI assistant into our product? Yes. You can create a NaBot session and post messages to it through Truto, which lets you embed game-accurate answers about rules, lore, or server context directly into your own UI. ## Related reading - [Connect NationsGlory to Claude: Manage Webhooks, Nabot & API Access](https://truto.one/blog/connect-nationsglory-to-claude-manage-webhooks-nabot-api-access/) — Learn how to connect NationsGlory to Claude using a generated MCP server. Automate webhooks, query MMR, and manage API access with natural language. - [Connect NationsGlory to ChatGPT: Analyze MMR, Notations & Rankings](https://truto.one/blog/connect-nationsglory-to-chatgpt-analyze-mmr-notations-rankings/) — A definitive engineering guide to connecting the NationsGlory API to ChatGPT using a managed MCP server. Automate MMR analysis, auction house tracking, and more. - [Connect NationsGlory to AI Agents: Automate Planning & HDV](https://truto.one/blog/connect-nationsglory-to-ai-agents-automate-auction-house-planning/) — Learn how to connect NationsGlory to AI agents using Truto's /tools endpoint. Fetch tools programmatically and build autonomous workflows for auction houses.