Skip to main content
Glama
Cavalera Forge MCP

Cavalera Forge MCP

by jbillochon

cavalera-forge-mcp

Star Citizen crafting, mining and trading for Claude and any MCP client. Everything the Cavalera Forge Discord bot answers, as MCP tools:

I want to craft the Arrowhead: what does it need, where do I mine it, and who sells the missing ingredient above quality 800?

Area

Tools

Crafting

product_recipe (ingredients, quantities, minimum quality, effect of ingredient quality on each stat), search_products, ingredient_uses, craftable_from, product_missions

Mining

mineral_info (one-stop card), mining_locations, list_minerals, identify_signature, refinery_yields

Trading

terminal_prices (best terminals), marketplace_search and marketplace_find_items (UEX player listings, combined filters)

Status

data_status (game version, data freshness)

Read-only, public data, no account needed. Prices and player listings come from the UEX marketplace. The marketplace part is uex-market-mcp.

Use it

Hosted instance (free, public, rate limited): https://forge.cavalera.news/mcp

  • Claude web / desktop / mobile: Settings > Connectors > Add custom connector, paste the URL, then Connect.

  • Claude Code: claude mcp add --transport http cavalera-forge https://forge.cavalera.news/mcp

Local (needs uv):

{
  "mcpServers": {
    "cavalera-forge": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/jbillochon/cavalera-forge-mcp", "cavalera-forge-mcp"]
    }
  }
}

The local server downloads the published databases (https://forge.cavalera.news/data/craft.db and market.db) once a day, and calls UEX directly for the marketplace.

Skill: skill/cavalera-forge/SKILL.md tells Claude which tool answers which question and how to read the results. Zip the folder and add it in Claude (Settings > Capabilities > Skills), or copy it to ~/.claude/skills/ for Claude Code.

Related MCP server: Blocksize Market Data

Data

  • craft.db is built by the Cavalera Forge pipeline from Star Citizen game data: 1 600+ products, recipes and quality modifiers, 670 missions, mining locations, mineable profiles, scan signatures, refinery yields. data_status gives the game version it matches.

  • market.db holds terminal sell prices from UEX, refreshed hourly.

Self-hosting over HTTP

pip install git+https://github.com/jbillochon/cavalera-forge-mcp
FORGE_DATA_DIR=/path/to/data FORGE_MCP_ALLOWED_HOSTS=forge.example.org \
  cavalera-forge-mcp --http --port 8793

Variable

Default

FORGE_DATA_DIR

folder with craft.db and market.db; unset: download the published copy

FORGE_DATA_URL

https://forge.cavalera.news/data

where to download from

FORGE_CACHE_DIR

~/.cache/cavalera-forge

downloads and UEX catalog cache

FORGE_MCP_ALLOWED_HOSTS

public host names accepted (DNS rebinding protection)

FORGE_MCP_OAUTH_SHIM / FORGE_MCP_PUBLIC_URL

off

auto-approving OAuth facade for claude.ai custom connectors (see uex-market-mcp)

UEX_MAX_CALLS_PER_MIN

40

outgoing UEX budget

deploy/ has the systemd unit and the nginx configuration of the hosted instance.

python -m unittest discover -s tests

Not affiliated with Cloud Imperium Games or UEX Corp. Trades between players happen at their own risk.

MIT License.

Available Tools

14 tools
craftable_fromCraftable from ingredientsA
Read-onlyIdempotent

Products craftable from the given ingredients: complete recipes first, then the ones closest to complete (slots covered / total).

Inputs: ingredients (required), limit, product_type.

data_statusData statusB
Read-onlyIdempotent

Game version the data is built for, data freshness, counts.

Inputs: no named parameters.

identify_signatureIdentify a scan signatureB
Read-onlyIdempotent

What a scanner signature can be: exact multiples of a mineral's ship signature (within its cluster size), ROC/FPS deposits or salvage panels, with the number of rocks or items.

Inputs: value (required).

ingredient_usesWhat uses an ingredientA
Read-onlyIdempotent

Products that use an ingredient, with quantities and a breakdown by product type.

Inputs: ingredient (required), limit, product_type.

list_mineralsList mineralsB
Read-onlyIdempotent

All minerals with their number of locations, systems, and whether they are crafting ingredients.

Inputs: no named parameters.

marketplace_find_itemsFind marketplace itemsA
Read-onlyIdempotent

Look up items in the UEX catalog (all items, not only crafting) to get exact names and ids for marketplace_search.

Inputs: query (required), limit, category.

mineral_infoMineral cardB
Read-onlyIdempotent

Everything about a mineral: best mining locations, scan signature per rock and method, extraction profile (resistance, instability, optimal window, explosion), quality bands, best and worst refineries, best terminal sell prices.

Inputs: mineral (required), locations.

mining_locationsMining locationsA
Read-onlyIdempotent

Where a mineral is found, most frequent first: place, system, place type, method (ship, ROC, FPS), share of deposits and concentration range. Without a name match, lists the minerals.

Inputs: mineral (required), limit, system.

product_missionsMissions rewarding a productA
Read-onlyIdempotent

Missions that can reward this product (blueprint or item), best paid first: type, faction, systems, reward, required standing.

Inputs: limit, product, product_id.

product_recipeProduct recipeA
Read-onlyIdempotent

Crafting recipe(s) of a product: per slot the ingredient, quantity, minimum quality, and how the ingredient quality moves each stat of the product (percent at lowest and highest quality). Also the craft time and how many missions reward the product.

Inputs: product, product_id.

refinery_yieldsRefinery yieldsA
Read-onlyIdempotent

Yield bonus or malus of every refinery for a material, best first.

Inputs: material (required).

search_productsSearch craftable productsA
Read-onlyIdempotent

Find craftable products by name (typo tolerant).

Inputs: query (required), limit, list_types, product_type.

terminal_pricesTerminal sell pricesC
Read-onlyIdempotent

Best trade terminals buying a mineral (refined and raw forms), price per SCU, from UEX, with the update time.

Inputs: mineral (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 14 tools

    Disambiguation3/5

    Most tools target distinct resources, but mineral_info ("Everything about a mineral") is a superset that explicitly overlaps with mining_locations, refinery_yields, and terminal_prices, leaving an agent unsure whether to use the aggregate or the slice. Similarly, search_products (craftable products) and marketplace_find_items (all catalog items) have nearby boundaries that require reading descriptions to separate.

    Naming Consistency4/5

    All names use snake_case and mostly follow a resource-first pattern (product_recipe, mineral_info, terminal_prices), which is predictable. Minor deviation: a few use verb ordering or bare verbs (marketplace_search, craftable_from, list_minerals), but overall readable and consistent.

    Tool Count5/5

    14 tools is well-scoped for a mining/crafting/marketplace data server, with each tool covering a distinct query concern (recipes, missions, locations, signatures, prices). No obvious filler or redundancy in count.

    Completeness4/5

    The surface covers the core lifecycle well: catalog lookup, product/recipe discovery, ingredient reverse-lookup, mission rewards, mining locations, signatures, refinery yields, and terminal prices. Minor gaps exist (e.g., no explicit ship/vehicle reference or price-history tooling), but core workflows are workable.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      This MCP server allows you to interact with the EVE Tycoon API to retrieve market data, price statistics, order books, and historical pricing information for EVE Online items across different regions.
      6
      4
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Read-only MCP server for Blocksize real-time market data: crypto VWAP, bid/ask, FX, metals and tokenized equities, with pricing, coverage and x402 endpoint lookup. Signed-in users of the Claude, ChatGPT and Cursor connectors get 30,000 free live-data credits every month (1 credit = $0.001); subscriptions from EUR 49/month.
      7
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server providing read-only access to Eve Online's Static Data Export (SDE), including ship stats, module attributes, universe data, blueprints, and more. Enables queries via tools like search_types, get_type, and compare_types.
      17
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to pull live, keyless worldstate data — the Plains of Eidolon day/night cycle, Cambion Drift, Orb Vallis, the daily Sortie, Baro Ki'Teer, active Void Fissures and Invasions — and to fuzzy-search item data such as warframes, weapons and mods. It can be reached through MCP clients, a scoped gateway endpoint, or directly over HTTP.
      300 npm
      MIT