Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
REST API for Warhammer 40,000 unit data — also available as an MCP server, so Claude (or any MCP client) can query it directly instead of you making manual HTTP calls. Edition-namespaced — currently serving 10th Edition (1,380 units across 35 factions) and 11th Edition (1,368 units across 35 factions).
:
Comprehensive Warhammer 40K API with 2,748 units across 35 factions and 2 game editions (10th and 11th). Built with FastAPI, featuring 29 endpoints. Also available as a live MCP server.
Interactive Docs: https://openhammer-api-production.up.railway.app/docs
Live MCP Server: https://openhammer-mcp-production.up.railway.app/mcp
All endpoints are namespaced by edition: /v1/{edition}/resource. The root endpoint lists all available editions.
The API is live at https://openhammer-api-production.up.railway.app
import requests
BASE = 'https://openhammer-api-production.up.railway.app'
edition = '10e'
# Get all factions
factions = requests.get(f'{BASE}/v1/{edition}/factions').json()
# Search for Space Marine units
units = requests.get(f'{BASE}/v1/{edition}/units?name=Marine&limit=10').json()
# Get a random unit
random_unit = requests.get(f'{BASE}/v1/{edition}/units/random').json()
const BASE = 'https://openhammer-api-production.up.railway.app';
const edition = '10e';
// Get API statistics
const stats = await fetch(`${BASE}/v1/${edition}/stats`).then(r => r.json());
// Search Necrons units
const units = await fetch(`${BASE}/v1/${edition}/units?faction=Necrons`).then(r => r.json());
BASE="https://openhammer-api-production.up.railway.app"
EDITION="10e"
# Get all factions
curl "$BASE/v1/$EDITION/factions"
# Search for Terminator units
curl "$BASE/v1/$EDITION/units?name=Terminator"
# Get faction details
curl "$BASE/v1/$EDITION/factions/Necrons/details"
With Python:
git clone https://github.com/EshanPrakash/openhammer-api.git
cd openhammer-api
pip install -r requirements.txt
uvicorn api.main:app --reload
With Docker:
git clone https://github.com/EshanPrakash/openhammer-api.git
cd openhammer-api
docker build -t openhammer-api .
docker run -p 8000:8000 openhammer-api
Visit http://localhost:8000/docs for interactive documentation.
pip install -r requirements-dev.txt
pytest
Tests run entirely in-process against both editions (no live server or network access needed) and cover search/filter/sort behavior, pagination, error cases, and edition parity across all 29 endpoints.
api/mcp_server.py exposes the same unit/faction/weapon data as MCP tools, so an MCP client (Claude Code, Claude Desktop, claude.ai) can query it directly instead of making manual HTTP calls. Tools call the in-process data store directly rather than the REST API.
The MCP server is live at https://openhammer-mcp-production.up.railway.app/mcp — no install needed.
claude mcp add --transport http openhammer https://openhammer-mcp-production.up.railway.app/mcp
Claude Desktop and claude.ai support the same URL as an HTTP/Streamable HTTP connector. This gives you 9 tools: list_editions, list_factions, search_units, get_unit, compare_units, random_unit, faction_details, search_weapons, search_abilities_or_rules.
Its dependencies are pinned separately in requirements-mcp.txt, since mcp needs newer starlette/anyio versions than the pinned fastapi==0.104.1 in requirements.txt supports.
With Python:
python3 -m venv venv-mcp
source venv-mcp/bin/activate
pip install -r requirements-mcp.txt
python -m api.mcp_server
With Docker:
docker build -f Dockerfile.mcp -t openhammer-mcp .
docker run -p 8001:8001 openhammer-mcp
Both serve Streamable HTTP on port 8001 (or $PORT, if set) at /mcp.
source venv-mcp/bin/activate
pip install -r requirements-mcp-dev.txt
pytest -c pytest-mcp.ini
Runs entirely in-process against the FastMCP instance via an in-memory client/server session (no live server, no network) and covers all 9 tools across both editions. Kept as a separate suite from pytest (which runs tests/) since it needs the mcp package.
The OpenHammer API provides 29 endpoints for accessing Warhammer 40K unit data:
/docsCurrent editions: 10e, 11e
Both editions cover the same 35 factions:
Adepta Sororitas, Adeptus Custodes, Adeptus Mechanicus, Agents of the Imperium, Astra Militarum, Black Templars, Blood Angels, Dark Angels, Deathwatch, Grey Knights, Imperial Fists, Imperial Knights, Iron Hands, Raven Guard, Salamanders, Space Marines, Space Wolves, Ultramarines, White Scars
Daemons, Chaos Knights, Chaos Space Marines, Death Guard, Emperor's Children, Thousand Sons, World Eaters
Aeldari, Genestealer Cults, Leagues of Votann, Necrons, Orks, Tyranids, T'au Empire
Titans, Unaligned Forces
Root
GET / - API info and list of available editionsStatistics & Info
GET /v1/{edition}/stats - Total units, factions, breakdown by typeFactions (5 endpoints)
GET /v1/{edition}/factions - List all factionsGET /v1/{edition}/factions/{faction_name}/units - Get faction unitsGET /v1/{edition}/factions/{faction_name}/details - Comprehensive faction detailsGET /v1/{edition}/factions/{faction_name}/stats - Statistical breakdownGET /v1/{edition}/factions/{faction_name}/keywords - Faction keywords with countsUnits (8 endpoints)
GET /v1/{edition}/units - Search/filter units (11 query parameters)GET /v1/{edition}/units/{unit_id} - Get specific unit by IDGET /v1/{edition}/units/search/name/{name} - Search by nameGET /v1/{edition}/units/random - Random unitGET /v1/{edition}/units/expensive - Most expensive units by pointsGET /v1/{edition}/units/cheap - Cheapest units by pointsGET /v1/{edition}/units/count - Count matching units without returning dataGET /v1/{edition}/units/compare - Compare multiple units by IDWeapons (3 endpoints)
GET /v1/{edition}/weapons/stats - Weapon statisticsGET /v1/{edition}/weapons/list - List all weapon namesGET /v1/{edition}/weapons/search/{name} - Search weapons, find units that have themAbilities & Keywords (5 endpoints)
GET /v1/{edition}/abilities/search/{term} - Search abilities by name or descriptionGET /v1/{edition}/abilities/keywords/list - List all keywordsGET /v1/{edition}/abilities/keywords/search/{keyword} - Find units by keywordGET /v1/{edition}/abilities/special-rules/list - List all special rulesGET /v1/{edition}/abilities/special-rules/search/{rule} - Find units by special ruleBulk Operations (6 endpoints)
GET /v1/{edition}/bulk/units/by-ids - Bulk lookup by IDsGET /v1/{edition}/bulk/units/by-names - Bulk lookup by namesGET /v1/{edition}/bulk/stats/by-keyword - Aggregate stats by keywordGET /v1/{edition}/bulk/stats/by-faction-type - Aggregate stats by faction typeGET /v1/{edition}/bulk/stats/by-faction - Aggregate stats by factionGET /v1/{edition}/bulk/export/all-units-summary - Export all units summaryBASE="https://openhammer-api-production.up.railway.app"
EDITION="10e"
# Get all Chaos units with invulnerable saves
curl "$BASE/v1/$EDITION/units?faction_type=Chaos&has_invuln=true"
# Get most expensive units
curl "$BASE/v1/$EDITION/units?sort_by=-points&limit=10"
# Get cheapest Imperium units
curl "$BASE/v1/$EDITION/units?faction_type=Imperium&sort_by=points&limit=20"
# Search for bolter weapons
curl "$BASE/v1/$EDITION/weapons/search/bolter"
# Get faction details for Necrons
curl "$BASE/v1/$EDITION/factions/Necrons/details"
# Get stats for all Infantry units
curl "$BASE/v1/$EDITION/bulk/stats/by-keyword?keyword=Infantry"
# Get comprehensive Imperium statistics
curl "$BASE/v1/$EDITION/bulk/stats/by-faction-type?faction_type=Imperium"
GET /v1/{edition}/units supports 11 filter and sorting parameters:
Sorting: sort_by=field for ascending, sort_by=-field for descending.
Data is stored in data/json/{edition}/ with one JSON file per faction:
Imperium_-_[Faction_Name].jsonChaos_-_[Faction_Name].jsonXenos_-_[Faction_Name].jsonUnaligned_-_[Faction_Name].jsonAdding a new edition is as simple as adding a new subdirectory — the API picks it up automatically on startup.
{
"name": "string",
"id": "string",
"type": "string",
"faction": "string",
"faction_type": "string",
"points": {
"base": number,
"variants": [{ "name": "string", "cost": number }]
},
"composition": {
"min_models": number,
"max_models": number
},
"stats": {
"M": "string",
"T": "string",
"SV": "string",
"W": "string",
"LD": "string",
"OC": "string"
},
"invuln_save": "string|null",
"transport": "string|null",
"weapons": {
"ranged": [
{
"name": "string",
"Range": "string",
"A": "string",
"BS": "string",
"S": "string",
"AP": "string",
"D": "string",
"Keywords": "string|null"
}
],
"melee": [
{
"name": "string",
"Range": "Melee",
"A": "string",
"WS": "string",
"S": "string",
"AP": "string",
"D": "string",
"Keywords": "string|null"
}
]
},
"abilities": [{ "name": "string", "description": "string" }],
"special_rules": ["string"],
"keywords": ["string"]
}
MIT License - see LICENSE file.
All Warhammer 40,000 content is property of Games Workshop.
Unit data sourced from BSData/wh40k-10e and BSData/wh40k-11e.
Comprehensive Warhammer 40K API with 2,748 units across 35 factions and 2 game editions (10th and 11th). Built with FastAPI, featuring 29 endpoints. Also available as a live MCP server.
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Openhammer Api läuft lokal über stdio.
Zuletzt geprüft: 2026-10-28. Comprehensive Warhammer 40K API with 2,748 units across 35 factions and 2 game editions (10th and 11th). Built with FastAPI, featuring 29 endpoints. Also available as a live MCP server.
