Cavalera Forge MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Cavalera Forge MCP What does it take to craft an Arrowhead, and where can I mine the ingredients?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
|
Mining |
|
Trading |
|
Status |
|
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.dbis 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_statusgives the game version it matches.market.dbholds 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 8793Variable | Default | |
| folder with craft.db and market.db; unset: download the published copy | |
|
| where to download from |
|
| downloads and UEX catalog cache |
| public host names accepted (DNS rebinding protection) | |
| off | auto-approving OAuth facade for claude.ai custom connectors (see uex-market-mcp) |
|
| outgoing UEX budget |
deploy/ has the systemd unit and the nginx configuration of the hosted
instance.
python -m unittest discover -s testsNot affiliated with Cloud Imperium Games or UEX Corp. Trades between players happen at their own risk.
MIT License.
Available Tools
14 toolscraftable_fromCraftable from ingredientsARead-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 statusBRead-onlyIdempotent
Game version the data is built for, data freshness, counts.
Inputs: no named parameters.
identify_signatureIdentify a scan signatureBRead-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 ingredientARead-onlyIdempotent
Products that use an ingredient, with quantities and a breakdown by product type.
Inputs: ingredient (required), limit, product_type.
list_mineralsList mineralsBRead-onlyIdempotent
All minerals with their number of locations, systems, and whether they are crafting ingredients.
Inputs: no named parameters.
marketplace_find_itemsFind marketplace itemsARead-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.
marketplace_searchSearch marketplace listingsARead-onlyIdempotent
UEX player marketplace listings with combined filters, ranked by quality, recency or price, one per seller, each with a direct link. Qualities read from titles are marked '~', defaults '500?'.
Inputs: item, sort, text, limit, +12 more.
mineral_infoMineral cardBRead-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 locationsARead-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 productARead-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 recipeARead-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 yieldsARead-onlyIdempotent
Yield bonus or malus of every refinery for a material, best first.
Inputs: material (required).
search_productsSearch craftable productsARead-onlyIdempotent
Find craftable products by name (typo tolerant).
Inputs: query (required), limit, list_types, product_type.
terminal_pricesTerminal sell pricesCRead-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
Scored across 14 tools
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.
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.
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.
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
Free, read-only MCP subset of x402 Toolbox's cheap data endpoints, free via MCP.
Read-only MCP server for The Quiet Protocol's engines, benchmarks, proof, and business data.
Read-only MCP for the Eco game wiki: search, Markdown pages, and wiki_* lookups. No keys, no writes.
Search MCP servers, MCP clients and AI agents, and retrieve listing details. Free, read-only access.
Related MCP Servers
- AlicenseAqualityDmaintenanceThis 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.64MIT
- AlicenseAqualityBmaintenanceRead-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.71MIT
- AlicenseAqualityBmaintenanceMCP 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.17MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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 npmMIT