MCP App Store
by KeenEthics
Terrava icon

Terrava MCP Server for ChatGPT

By 41 Shades LLC

Overview

Explore 8,000+ years of empires, kingdoms, and changing borders on an interactive globe. Ask for a polity or year, follow its mapped history, read profiles and sources, or start a Living Journey. View associated artwork and living environments where available, or explore the sky. Historical maps are interpretations: coverage and evidence vary, and dates and boundaries may be approximate or revised. No sign-in is required.

How to connect

  1. ChatGPT: Open the Terrava listing in the ChatGPT app directory and choose Connect. ChatGPT listing Terrava exposes 25 tools here.

Tools

configure_atlas

ChatGPT
Configure the atlas date, relations, globe camera or bounds, names, borders and playback settings within the pinned release. Requires a connected atlas_instance_id from the latest app context; never opens a new card. Wait for each action to finish before sending the next dependent action.

configure_sky

ChatGPT
Set live-sky culture, celestial labels, constellation lines/names/illustrations through the shared Cosmos controls. Preserves historical date and dataset revision. Live model context reports settings; atlas links do not encode them. Requires a connected atlas_instance_id from the latest app context; never opens a new card. Wait for each action to finish before sending the next dependent action.

connect_atlas

ChatGPT
Establish a transient command connection for the mounted atlas.

control_environment

ChatGPT
Control the mounted, ready living environment: play, pause, seek to progress 0–1, or reset. Seek/reset pause; reduced motion prevents play. The fixed media date remains independent of atlas time. Requires a connected atlas_instance_id from the latest app context; never opens a new card. Wait for each action to finish before sending the next dependent action.

control_playback

ChatGPT
Play, pause, or resume the current journey, polity, or timeline. Play can restart completed playback; resume preserves progress. get_atlas_context reports its live phase. Requires a connected atlas_instance_id from the latest app context; never opens a new card. Wait for each action to finish before sending the next dependent action.

get_atlas_context

ChatGPT
Read Terrava's current presentation, gallery context, underlying atlas state, music/sky preferences, and canonical route. Supply atlas_instance_id to read the mounted atlas; without a connected atlas, rendered inspection is unavailable.

inspect_polity

ChatGPT
Read authored identity, published presence, interpretation, relationships, evidence, and citations for one published polity.

inspect_visible_scene

ChatGPT
Read readiness and evidence for the visible atlas, live sky or gallery. An open artwork or living environment returns its presentation context, not obscured map features. No geometry or bulk release data. Supply atlas_instance_id to read the mounted atlas; without a connected atlas, rendered inspection is unavailable.

list_authored_journeys

ChatGPT
List the published Terrava journey catalog and each journey's ordered moments.

list_polity_changes

ChatGPT
List authored recorded changes for one polity within an optional date window.

open_authored_journey

ChatGPT
Start a published journey. get_atlas_context reports its live playback phase. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.

open_terrava

ChatGPT
Open a new Terrava Home card by default; atlas_instance_id or canonical_url restores that view in a new card. show_polity opens a named polity. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.

return_home

ChatGPT
Run Terrava's Home action: stop playback, clear selection and reset date, camera and layers to Home in the latest available release. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.

search_countries

ChatGPT
Find present-day reference countries by name or code. Returns at most 20 country IDs and names, without historical claims or geometry.

search_sky

ChatGPT
Find supported celestial objects, Polaris, Pleiades, galaxies, Orion Nebula, and constellations across sky cultures. Returns at most 20 stable IDs and names; live sky is independent of the historical atlas date.

search_terrava

ChatGPT
Search polities, dates, time ranges, political changes, and authored journeys in the selected immutable Terrava release.

show_authored_journey_moment

ChatGPT
Open a one-based published journey moment as an ordinary selected, shareable atlas scene. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.

show_constellation

ChatGPT
Select a constellation by culture and constellation_id, enabling that culture. Historical date and release are unchanged. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.

show_country

ChatGPT
Select and frame a present-day country using country_id from search_countries. Enables modern borders and country names, pauses playback, and preserves the historical date and range. To explore Greece or another country through history, select it first (via update_atlas for an explicit existing-map request), then configure_atlas with the historical range and control_playback on that same atlas_instance_id. Camera bounds alone do not select a country. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.

show_polity

ChatGPT
Find Athens or another historical polity by query (name or alias) or polity_id, exactly one. Without scene_version, navigation uses the latest frame. An undated request uses the polity's first map state; ambiguous names return choices. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.

show_polity_change

ChatGPT
Open one exact authored polity change with its affected bounds, relation layer, before/after record, and evidence. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.

show_sky_object

ChatGPT
Select a supported celestial object by object_id. Historical date and release are unchanged. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.

update_atlas

ChatGPT
Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded. Requires atlas_instance_id and a command, for example {name: "show_polity", arguments: {query: "Carthage"}}. Returns no widget and waits for the target map's ready-frame report; disconnected targets return an error. Never create a replacement card when the target is unavailable.

Capabilities

WritesInteractive

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/terrava"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/terrava)