SpaceTraders

by grantmd

Not rated
GitHub

About

An MCP server for interacting with the SpaceTraders API, a space-based trading and exploration game.

Details

Author
grantmd
Categories
Other, API

Setup

Install SpaceTraders in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/grantmd/spacetraders-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

A Model Context Protocol (MCP) server that provides seamless integration between any MCP client and the SpaceTraders API, enabling automation, analysis, and discussion about the current state of your SpaceTraders game state.

Most of this is being "written" via LLM tools as a personal experiment, which is probably unsurprising given the target audience, but I wanted to make that clear upfront.

- 🤖 Intelligent Game Assistant: Get contextual advice and strategic recommendations
- 📊 Real-time Data Access: Automatic access to your ships, contracts, and systems
- 🛠️ Automated Actions: Execute complex operations through natural language
- 🗺️ Smart Exploration: Intelligent system mapping and facility discovery
- 📈 Strategic Analysis: Contract optimization and fleet management recommendations
- 🚢 Advanced Ship Management: Individual ship monitoring with real-time cooldown tracking
- 📦 Contract Workflow: Complete contract delivery system with incremental goods delivery

- Go 1.21 or higher
- Java 8+ andOpenAPI Generator(formake buildon fresh clone;brew install openapi-generatoron macOS)
- Any MCP Client
- SpaceTraders API token (
Get one here)

git clone https://github.com/grantmd/spacetraders-mcp.git cd spacetraders-mcp

Build the server(auto-generates the SpaceTraders API client if needed):

export SPACETRADERS_TOKEN=your_token_here

Configure Claude Desktop (or other client):

Edit~/Library/Application Support/Claude/claude_desktop_config.json(Claude macOS):

{ "mcpServers": { "spacetraders": { "command": "/path/to/spacetraders-mcp/spacetraders-mcp", "args": [] } } }

Restart your clientand start exploring!

- "Show me my current SpaceTraders status"- Get a complete overview
- "What systems should I explore next?"- Get strategic recommendations
- "Help me optimize my fleet"- Analyze and improve your ships
- "Find the best trading opportunities"- Discover profitable routes

Detailed documentation is available in thedocs/folder:

- Resources- Available data resources and how to use them
-
Ship Resources- Individual ship monitoring and cooldown tracking
-
Tools- Actions you can perform through Claude
-
Prompts- Intelligent assistance for common tasks
-
Integration- Claude Desktop setup and configuration
-
MCP Resources Guide- Understanding how MCP resources work
-
Development- Contributing and extending the server
-
Testing- Running tests and quality assurance
-
Troubleshooting- Common issues and solutions
-
API Reference- Complete API documentation
-
CI/CD- Automated workflows and deployment

- Check agent status, credits, and fleet overview
- Monitor ship locations, cargo, and fuel levels
- Real-time ship cooldown monitoring- Know exactly when ships are ready for actions
- Individual ship analysis- Comprehensive ship status with operational recommendations
- Review and manage contracts
- Incremental contract delivery- Deliver goods to contracts in multiple trips
- Track system exploration progress

- Navigate ships between waypoints and systems
- Extract resources and manage cargo
- Smart cooldown management- Plan actions around ship availability
- Fleet coordination- Monitor multiple ships' operational status
- Find optimal trading routes and opportunities
- Purchase and configure new ships
- Complete contract workflows- Accept, deliver, and fulfill contracts efficiently

- Get recommendations based on your current situation
- Operational status analysis- Understand what each ship can do right now
- Capability detection- Automatic identification of ship roles (mining, trading, etc.)
- Analyze systems for facilities and resources
- Optimize contract selection and completion strategies
- Action planning- Get suggestions based on ship cooldowns and capabilities
- Plan fleet composition and expansion

1. "Check my contracts" - Review available and accepted contracts 2. "Show me ship TRADER-1 status" - Check ship location and cargo capacity 3. "Navigate TRADER-1 to the delivery location" 4. "Buy the required goods for the contract" 5. "Deliver goods to contract CONTRACT_123" - Incremental delivery 6. "Check cooldown for TRADER-1" - Monitor when ready for next action 7. "Fulfill the contract" - Complete and claim rewards
1. "Show me all ship cooldowns" - Monitor fleet availability 2. "Which ships are ready for mining?" - Find available extraction ships 3. "Check ship MINER-1 detailed status" - Comprehensive operational analysis 4. "Plan next actions based on cooldowns" - Strategic fleet coordination
"Explore system X1-DF55 and tell me what facilities are available"
"Where are all my ships and what should I do with them?"
"Analyze my current cargo and find the best places to sell"
"Review my contracts and suggest the most profitable completion order"

- First time setup?Check theIntegration Guide
- Having issues?See the
Troubleshooting Guide
- Want to contribute?Read the
Development Guide
- Found a bug?
Open an issue

Apache License - seeLICENSEfor details.

Contributions are welcome! Please see ourDevelopment Guidefor details on how to get started.

Manage stock and crypto portfolios, place trades, and access market data via the Alpaca Trading API.

An MCP server for brokerage functionalities, built with the MCP framework.

Connects Large Language Models (LLMs) with Guild Wars 2 data sources. Requires a Guild Wars 2 API key for wallet functionality.

A simple MCP server to interact with prediction market Kalshi

A server for performing trading operations using the Kite Connect API.

Korea Investment & Securities (KIS) REST API

Provides stock trading and market data using the Korea Investment & Securities (KIS) REST API.

Interact with the Lichess chess platform using natural language.

Fetches Pokémon data from the PokeAPI and exposes it through a standardized MCP interface.

An unofficial server to integrate with the Questrade API, providing access to trading accounts, market data, and portfolio information.

Access the Shioaji trading API for financial data and trading operations, requiring a SinoPac Securities account.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.