fio-mcp
A Model Context Protocol (MCP) server for the FIO community API, giving LLMs access to game data from Prosperous Universe.
Prerequisites
- Node.js >= 18
- A FIO API key (get one at https://fio.fnar.net/settings/api)
- Your Prosperous Universe username
Quick Start
npx (no install)
{
"mcpServers": {
"fio": {
"command": "npx",
"args": ["-y", "fio-mcp"],
"env": {
"FIO_API_KEY": "your_api_key",
"FIO_USERNAME": "YourIngameName"
}
}
}
}
Claude Code
Add to ~/.claude/settings.json:
{
"mcpServers": {
"fio": {
"command": "npx",
"args": ["-y", "fio-mcp"],
"env": {
"FIO_API_KEY": "your_api_key",
"FIO_USERNAME": "YourIngameName"
}
}
}
}
From source
git clone https://github.com/themanwithanrx7/fio-mcp.git
cd fio-mcp
pnpm install
pnpm build
Then point your MCP client at the built output:
{
"mcpServers": {
"fio": {
"command": "node",
"args": ["/path/to/fio-mcp/dist/index.js"],
"env": {
"FIO_API_KEY": "your_api_key",
"FIO_USERNAME": "YourIngameName"
}
}
}
}
Environment Variables
| Variable | Required | Description |
|---|---|---|
FIO_API_KEY | Yes | FIO API key or AuthToken |
FIO_USERNAME | No | Prosperous Universe username (used as default for user-specific tools) |
Available Tools
Market & Exchange
| Tool | Description |
|---|---|
fio_get_exchange | Commodity exchange data for a ticker (e.g. CU.NC1) |
fio_get_all_exchanges | Summary of all commodity exchanges |
fio_get_exchange_full | Price snapshot for all active materials across all exchanges |
fio_get_price_history | Historical daily price data for a ticker |
fio_get_exchange_orders | Open exchange orders for a company |
fio_get_exchange_trades | Exchange trade history for a user |
fio_get_exchange_trades_csv | Exchange trade history as CSV |
fio_get_local_market | Local market ads for a planet |
fio_search_local_market | Search local markets for a material |
fio_get_company_local_market | Local market ads by company |
Planets & Navigation
| Tool | Description |
|---|---|
fio_get_all_planets | List all planets (minimal data) |
fio_get_planet | Full planet details |
fio_search_planets | Search planets by criteria |
fio_get_planet_sites | Player-built sites on a planet |
fio_get_all_systems | All star systems |
fio_get_system | Star system details |
fio_get_infrastructure | Planet infrastructure details |
fio_get_jump_count | Jump count between two systems |
fio_get_jump_route | Full jump route between two systems |
Production & Materials
| Tool | Description |
|---|---|
fio_get_all_buildings | All buildings with costs and workforce |
fio_get_building | Building details by ticker |
fio_get_all_materials | All materials with categories and weights |
fio_get_material | Material details by ticker |
fio_get_materials_by_category | Materials in a category |
fio_get_all_recipes | All production recipes |
fio_get_workforce_needs | Workforce consumption rates by tier |
fio_get_production | User's production lines (all planets) |
fio_get_production_on_planet | User's production lines on a planet |
Account & Logistics
| Tool | Description |
|---|---|
fio_get_storage | User's storage across all bases |
fio_get_storage_on_planet | User's storage on a planet |
fio_get_ships | User's ships |
fio_get_ship_flights | Ship flight data (location, destination, ETA) |
fio_get_ship_fuel | Ship fuel stores |
fio_get_sites | All base sites in the game |
fio_get_workforce | User's workforce across all bases |
fio_get_workforce_on_planet | User's workforce on a planet |
fio_get_contracts | User's contracts (filterable by status/days/limit) |
fio_get_contract_concerns | Contracts needing attention |
fio_get_contract_shipments | Shipment location tracking |
fio_get_burn_rate | Consumable supply burn rate per base |
fio_get_user | User public profile |
User-specific tools accept an optional userName parameter and default to FIO_USERNAME.
Development
pnpm install
pnpm dev # Run with tsx (no build needed)
pnpm build # Compile TypeScript
pnpm test # Run tests
pnpm lint # Lint with oxlint
pnpm fmt # Format with oxfmt
pnpm fmt:check # Check formatting
pnpm check # fmt:check + lint + build
License
MIT