get_status_summaryLABSCO SUMMARY
Turns fleet micromanagement into a conversation.
The tools that matter most are not the individual actions but the ones that summarise state: one call gives you agent, ships and contracts together, and cooldown tracking means the assistant can tell you what is possible this minute rather than listing everything a ship could theoretically do. Contract delivery is modelled properly too, as multiple trips rather than a single all-or-nothing call. Documentation lives in the repo's docs folder, tool by tool, if you want the full parameter list before you start.
What it is
A Go MCP server that connects an MCP client to the SpaceTraders API, so you can inspect and change your game state by asking, and get strategy suggestions grounded in what your fleet can actually do right now.
What you get
- Situation reads:
get_status_summaryfor agent, ships and contracts in one call,current_location,analyze_fleet_capabilitiesandget_contract_info - Movement:
orbit_ship,dock_ship,navigate_ship,patch_ship_nav,warp_shipandjump_ship - Exploration:
find_waypointsfiltered by type or trait,system_overview, and thescan_systems,scan_waypointsandscan_shipstrio - Economy:
buy_cargo,sell_cargo,jettison_cargo,refuel_ship,repair_shipandpurchase_ship - Contract workflow end to end:
accept_contract, incremental deliveries, thenfulfill_contract - Real-time cooldown tracking per ship, so the assistant plans around when a ship is next able to act
Requirements
Go 1.21 or higher, plus Java 8+ and OpenAPI Generator for make build on a fresh clone, since the build generates the SpaceTraders API client. Export your SpaceTraders API token as SPACETRADERS_TOKEN and point the client at the built binary.
Setup effort
Build from source — git clone https://github.com/grantmd/spacetraders-mcp.git
USE CASES
01
Deciding what to do next
Pull the status summary and the fleet analysis, and let the assistant weigh contracts against what your ships can reach.
02
Finishing a contract that needs several trips
Accept it, extract and deliver in batches as cargo space allows, then fulfil it when the requirement is met.
03
Finding a shipyard or a marketplace
Search a system's waypoints by trait rather than paging through them by hand.
04
Moving a ship without stranding it
Check fuel, refuel at the current waypoint, then navigate — navigation tools burn fuel.
24 tools
Listed in project docs. Your client may show a different list.
get_contract_infoanalyze_fleet_capabilitiesaccept_contractfulfill_contractpurchase_shiprefuel_shiprepair_shipextract_resourcesjettison_cargobuy_cargosell_cargoorbit_shipdock_shipnavigate_shippatch_ship_navwarp_shipjump_shipfind_waypointssystem_overviewcurrent_locationscan_systemsscan_waypointsscan_shipsBEFORE YOU INSTALL
What to know first
Tools you get
24 tools named in the project's documentation. The tools include actions such as purchase_ship, refuel_ship, extract_resources, buy_cargo, sell_cargo, accept_contract and fulfill_contract, not just reads.
Requires
- Go 1.21 or later
- Java 8+
- SPACETRADERS_TOKEN in your environment
Where it runs
All 3 documented setups run the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/grantmd/spacetraders-mcp.git
cd spacetraders-mcp
make build
export SPACETRADERS_TOKEN=<YOUR_SPACETRADERS_TOKEN>Add the mcpServers entry below to claude_desktop_config.json and restart the client
MCP Clients
Claude Desktop — macOS, Linux
JSON
{
"mcpServers": {
"spacetraders": {
"command": "<YOUR_PATH_TO_SPACETRADERS_MCP_SPACETRADERS_MCP>",
"args": []
}
}
}Claude Desktop — inline env vars
CLAUDE DESKTOP — INLINE ENV VARS · JSON
{
"mcpServers": {
"spacetraders": {
"command": "<YOUR_PATH_TO_SPACETRADERS_MCP_SPACETRADERS_MCP>",
"args": [],
"env": {
"SPACETRADERS_TOKEN": "<YOUR_SPACETRADERS_TOKEN>",
"SPACETRADERS_AGENT_SYMBOL": "<YOUR_SPACETRADERS_AGENT_SYMBOL>"
}
}
}
}
