SkyFi

SkyFi MCP Server exposes a suite of tools that integrate SkyFi's satellite imagery capabilities into your AI workflows. It offers 21 tools across three categories: SkyFi imagery tools (archive search, tasking quotes, orders, monitoring, pricingAnalysis), OpenStreetMap tools (geocoding and related features), and helper utilities for price estimation and feasibility analysis. After starting the server, you can invoke tools such as skyfi_archive_search to locate imagery in the archive, skyfi_get_tasking_quote to obtain a pricing and feasibility quote before ordering, skyfi_create_archive_order or skyfi_create_tasking_order to place orders, and skyfi_setup_area_monitoring to automate monitoring for a region. The OpenStreetMap tools, like osm_forward_geocode, enable geocoding queries. This setup is designed to feed AI assistants with imagery data, tasking capabilities, and geospatial context seamlessly through MCP clients.

Prerequisites:\n- Python 3.11+\n- SkyFi API credentials (API key in the format email:hash)\n- Optional: OpenWeatherMap API key for weather integration\n\nStep-by-step installation:\n1) Clone the repository and install local package in editable mode:\n\nbash\n# Clone the repository\ngit clone https://github.com/PSkinnerTech/SkyFi-MCP.git\ncd SkyFi-MCP\n\n# Install dependencies in editable mode\npip install -e .\n\n2) Ensure a Python environment is active (venv/conda/poetry) and that SKYFI_API_KEY and SKYFI_URL are available to the server via environment variables.\n3) Run the MCP server (example HTTP transport shown in notes):\n\nbash\npython -m mcp_skyfi --transport http --port 8000\n\n4) Confirm the server starts and is reachable by sending a test request to the configured port.\n\nPrerequisites recap: ensure Python path resolution (absolute path to python) and that the working directory points to the project root containing the mcp_skyfi module. You may also run within a virtual environment or using Poetry as described in the README.

Environment variables and configuration tips:\n- Required: SKYFI_API_KEY and SKYFI_URL must be provided in the client config or as environment variables. The API key should be in the email:hash format.\n- Optional: OPENWEATHER_API_KEY for weather data integrations.\n- MCP_LOG_LEVEL and MCP_LOG_FORMAT can be set to control logging (e.g., INFO, DEBUG; console, json).\n- For testing HTTP transport, you can start the server with: python -m mcp_skyfi --transport http --port 8000.\nCommon issues: ensure the absolute path to the Python executable is used and that the working directory is the repository root where mcp_skyfi is located. If you encounter missing module errors, verify that the package was installed in editable mode and that the PYTHONPATH includes the project.\nTools availability: after startup, you should see 21 tools available (13 SkyFi tools and 8 OSM tools). The SkyFi tools cover archive search, details, quotes, orders, monitoring, and pricing analysis, while OSM tools provide geocoding capabilities.