1. Conduid
  2. Science
  3. Fio
MCP server · Science

Fio

· github.com/themanwithanrx7/fio-mcp

A Model Context Protocol server for FIO / Prosperous Universe

Unclaimed model-context-protocolmcpfioprosperous-universemcp-server
InstallView source
37Low

Scored 4 months ago · breakdown

About Fio

Fio is an MCP server in the Science category: a Model Context Protocol server for FIO / Prosperous Universe. It has been installed 0 times through Conduid.

Install

Claude Code
claude mcp add fio -- npx -y fio-mcp
npx
npx -y fio-mcp

This 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.

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 presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • ·Scoped permissionsNot checked 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

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 mirrored from the source repository 4 months ago. The original is authoritative.

Questions

About Fio

How do I install Fio?

Run claude mcp add fio -- npx -y fio-mcp, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is Fio safe to use with an AI agent?

Its trust score is 37 out of 100 (low). Conduid hasn't run static security checks on this repository yet, so review the source yourself before granting it credentials. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Fio still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.