About Fio
Fio is an MCP server in the Science category: a Model Context Protocol server for FIO / Prosperous Universe.
Install
Claude Code
claude mcp add fio -- npx -y fio-mcpnpx
npx -y fio-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (10)
fio_get_all_exchangesSummary of all commodity exchanges
Parameters not published.
fio_get_company_local_marketLocal market ads by company
Parameters not published.
fio_get_exchangeCommodity exchange data for a ticker (e.g. `CU.NC1`)
Parameters not published.
fio_get_exchange_fullPrice snapshot for all active materials across all exchanges
Parameters not published.
fio_get_exchange_ordersOpen exchange orders for a company
Parameters not published.
fio_get_exchange_tradesExchange trade history for a user
Parameters not published.
fio_get_exchange_trades_csvExchange trade history as CSV
Parameters not published.
fio_get_local_marketLocal market ads for a planet
Parameters not published.
fio_get_price_historyHistorical daily price data for a ticker
Parameters not published.
fio_search_local_marketSearch local markets for a material
Parameters not published.
Ask AI
✦
Ask AI about Fio
Powered by Claude · Grounded in docs
I know everything about Fio. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.