LLM Integration
Use AI assistants like Claude Code to build Hathor integrations faster. Two complementary tools are available:
- Hathor Skills — instruction packages that teach your LLM Hathor-specific rules and workflows
- Hathor Forge MCP — lets an AI assistant directly control a local Hathor development environment
Quick reference
hathor-wallet-headless skill
Use when building wallet backends, payment flows, token operations, NFTs, atomic swaps, multisig, or nano contract calls through Headless Wallet.
Activate with:
/hathor-wallet-headless
Example prompts:
/hathor-wallet-headless
I want to build a backend endpoint that sends HTR.
Give me the architecture, the Headless Wallet operations involved, and the security concerns.
Do not write code yet.
/hathor-wallet-headless
Review this Headless Wallet integration. Check that wallet operations are server-side only,
amounts are converted before API calls, and no secrets are logged.
[paste code]
→ Full guide: Headless Wallet Skill
hathor-blueprint skill
Use when creating, reviewing, or debugging Hathor nano contract blueprints written in Python.
Activate with:
/hathor-blueprint
Example prompts:
/hathor-blueprint
I need a token vault blueprint that lets users deposit one token and withdraw up to their balance.
Before writing code, give me the persistent fields, public methods, view methods, and validation risks.
/hathor-blueprint
Review this blueprint: correct class structure, persistent fields initialized, @public and @view used correctly,
no unsupported imports or float arithmetic.
[paste blueprint]
→ Full guide: Blueprint Skill
Hathor Forge MCP
Use when you want your AI assistant to control a local Hathor development environment — start services, create wallets, fund them, send transactions, and inspect blocks.
Start Forge and connect:
Hathor Forge requires Nix with flakes enabled. Install Nix first if you don't have it.
nix run github:HathorNetwork/hathor-forge -- --start
claude mcp add --transport http hathor-forge http://127.0.0.1:9876/mcp
Example prompts (no code needed — Claude uses the MCP tools directly):
Start my local Hathor environment and tell me which services are running.
Create a wallet named demo, fund it with 50 local HTR, then send 10 HTR to a second wallet named receiver.
Show the final balances.
→ Full guide: Hathor Forge MCP
Choose the right tool
| I want to… | Use |
|---|---|
| Build a wallet backend or payment flow | Headless Wallet Skill |
| Create or debug a nano contract blueprint | Blueprint Skill |
| Run a local Hathor stack, submit and test contracts, create wallets with AI control | Hathor Forge MCP |
| Test locally before connecting to testnet | Forge + the relevant skill together |
Starter projects
Starter projects for each integration are available in the hathor-skills repository under the starters/ directory.
Security
Never paste wallet seeds, private keys, production API keys, or privileged credentials into an LLM session. Do not expose MCP servers on public or shared networks. Treat LLM-generated wallet configuration and transaction code as untrusted until you verify it against official Hathor documentation.
Installation
If you already have the skills installed, you can skip this section.
1. Clone the repository
git clone https://github.com/HathorNetwork/hathor-skills.git
2. Copy the skills you need
Personal installation (available in all Claude Code sessions):
mkdir -p ~/.claude/skills
cp -r hathor-skills/skills/hathor-blueprints ~/.claude/skills/hathor-blueprint
cp -r hathor-skills/skills/hathor-wallet-headless ~/.claude/skills/hathor-wallet-headless
Project-level installation (shared with your team):
mkdir -p .claude/skills
cp -r /path/to/hathor-skills/skills/hathor-blueprints .claude/skills/hathor-blueprint
cp -r /path/to/hathor-skills/skills/hathor-wallet-headless .claude/skills/hathor-wallet-headless
git add .claude/skills && git commit -m "Add Hathor Claude Code skills"
The installed folder name must match the name field inside each SKILL.md. Install hathor-blueprints as hathor-blueprint (without the trailing s).
3. Restart Claude Code
Skills load at startup. After restarting, verify with /hathor-wallet-headless or /hathor-blueprint.
Use with other LLMs
The SKILL.md standard is designed to be adopted broadly. Many tools and agents can load skills from a skills directory automatically. For tools that don't yet support it natively, paste the relevant SKILL.md file as context and tell the LLM to follow its guidance when working with Hathor.