Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
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.
เปิดจากผู้เผยแพร่
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.
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Openhammer Api ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 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.
