ORDnet MCP Server
OfficialEnables AI agents to create permanent content on the Bitcoin SV blockchain using 1SatOrdinals, including inscriptions (HTML, JSON, text, images), domain registration, payments/transfers, and wallet management.
Click on "Install 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., "@ORDnet MCP ServerInscribe my blog post as an HTML page on Bitcoin SV"
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.
ORDnet MCP Server v3.1
Enable AI agents to create Web3 content on Bitcoin SV blockchain
Overview
ORDnet MCP Server enables AI agents (Claude, GPT, etc.) to create permanent, censorship-resistant content on the Bitcoin SV blockchain using the 1SatOrdinals protocol. This is a key component of the freedom of speech infrastructure - allowing AI to autonomously publish Web3 content.
Key Features
43 MCP Tools for complete blockchain content creation, payments and transfers
BRC-100 aligned identity (v3.0):
ordnet_identity,ordnet_sign_message,ordnet_verify_message,ordnet_derive_payment_address— agent identity, off-chain signing, and per-invoice payment-address derivation as the foundation for x402Agent payments:
ordnet_send(P2PKH + optional OP_RETURN reference, miner fee only — x402-ready),ordnet_transferfor ordinals/domains (1SatOrdinals input-0/output-0 semantics, outpoint verified via own node)Binary inscriptions via
ordnet_inscribe_binary(base64 → bytes untouched); BSVmap tile claims viaordnet_bsvmap_inscribeAgent conveniences:
ordnet_tx_status(confirmations via own node),ordnet_price(via own CoinGecko proxy)3 MCP Prompts (
prompts/list): inscribe-website, register-domain, agent-payment1SatOrdinals inscriptions (HTML, JSON, text, images, etc.)
SNS/OPNS domain registration (.sats, .btc, .bsv, etc.)
3-tier wallet security (env vars → encrypted → plaintext; plaintext-WIF tools are disabled on the HTTP transport)
Agent safety layer: tx simulation via ORDnet's own node + spend limits with operator-set hard ceilings (fail-closed)
HTTP transport with mandatory bearer auth (
ORDNET_MCP_AUTH_TOKEN, server refuses to start without it)Fee structure identical to ordmail-v10-standalone-026.html: 396 sats service fees across 11 outputs / 10 addresses, miner fee 0.15 sat/byte (min. 200 sats)
Related MCP server: aibtc-mcp-server
Quick Start
Installation
git clone https://github.com/ORDNET/ORDnet-MCP-Server.git && cd ORDnet-MCP-Server
npm install && npm run buildNote: the package is not (yet) published on npm; install from source.
Usage with Claude Desktop
Add to your Claude Desktop config (~/.config/claude/claude_desktop_config.json):
{
"mcpServers": {
"ordnet": {
"command": "npx",
"args": ["@ordnet/mcp-server"],
"env": {
"ORDNET_WIF": "your-wif-private-key"
}
}
}
}Usage with OpenClaw
{
"mcp_servers": [
{
"name": "ordnet",
"command": "node",
"args": ["/path/to/ordnet-mcp-server/dist/index.js"],
"env": {
"ORDNET_WIF": "your-wif-private-key"
}
}
]
}Service Fees
All inscriptions include a service fee of 2,775 satoshis distributed as follows:
Fee | Amount | Purpose |
Builders | 111 sats | Tool development |
Protocol | 222 sats | 1SAT protocol |
Monitor | 333 sats | WhatsOnChain |
Indexer | 444 sats | Gorillapool |
Creator | 777 sats | ARTaY |
Foundation | 888 sats | ORDnet.io |
Fee Address: 1EXupec98g8TDTG5cwJwH3U8V3PezvvLv8
Tools Reference
Wallet Management (6 tools)
Tool | Description |
| Initialize wallet from WIF private key |
| Initialize from environment variable (recommended) |
| Check wallet status and balance |
| Get balance for any BSV address |
| Get unspent transaction outputs |
| Clear wallet from memory |
Inscriptions (6 tools)
Tool | Description |
| Calculate fee for an inscription |
| Prepare inscription (no broadcast) |
| Broadcast prepared transaction |
| Quick HTML inscription |
| Quick JSON inscription |
| Quick plain text inscription |
Domains (6 tools)
Tool | Description |
| Check domain availability |
| Get domain information |
| Search registered domains |
| Register SNS/OPNS domain |
| Quick SNS registration |
| Quick OPNS registration |
Search & Lookup (4 tools)
Tool | Description |
| Search inscriptions |
| Get inscription details |
| Get content URLs |
| Validate BSV address |
Security (4 tools)
Tool | Description |
| Encrypt WIF with AES-256-GCM |
| Check security tier |
| Validate password strength |
| Generate new random wallet |
Utilities (2 tools)
Tool | Description |
| Server information |
| List supported content types |
Example: Create an HTML Inscription
User: Create a simple webpage saying "Hello from AI" and inscribe it on Bitcoin
AI: I'll create and inscribe this HTML content on the BSV blockchain.
1. First, let me initialize the wallet...
[ordnet_wallet_init_env]
✓ Wallet initialized at 1ABC...
2. Creating the HTML inscription...
[ordnet_inscribe_html] content="<html><body><h1>Hello from AI</h1></body></html>"
✓ Inscription successful!
- TXID: abc123...
- Inscription ID: abc123..._0
- View: https://ordnet.io/view/abc123..._0Supported Content Types
text/html;charset=utf8- HTML web pagestext/plain;charset=utf8- Plain textapplication/json- JSON dataimage/svg+xml- SVG graphicsimage/png- PNG imagesimage/jpeg- JPEG imagesimage/gif- GIF animationsimage/webp- WebP imagesaudio/mpeg- MP3 audiovideo/mp4- MP4 videoapplication/pdf- PDF documents
Supported Domain Extensions
Universal
.sats
Chain-specific
BTC:
.btc.ord.xbt.gm.unisat.xBSV:
.bsvDOGE:
.doge.shibeLTC:
.ltcBCH:
.bchBELLS:
.bellsAnd more...
Security Tiers
Tier | Method | Security Level |
Environment |
| ⭐⭐⭐ Highest |
Encrypted | AES-256-GCM encrypted store | ⭐⭐ Medium |
Plaintext | Direct WIF input | ⭐ Lowest |
Recommendation: Always use environment variables in production.
Development
# Clone and install
git clone https://github.com/ordnet/mcp-server
cd mcp-server
npm install
# Build
npm run build
# Run tests
node test/transaction-test.mjs
# Start server (stdio)
npm start
# Start server (HTTP)
TRANSPORT=http PORT=3000 npm startTransaction Structure
Transactions are byte-identical to the reference inscriber (ORD-inscriber-pro-009.html):
Input: UTXO (user funds)
Output 0: 1 sat - Inscription (OP_FALSE OP_IF "ord" ... OP_ENDIF + P2PKH)
Output 1: 1 sat - OP_RETURN "ORDnet.io"
Output 2: 111 sats - Builders fee
Output 3: 222 sats - Protocol fee
Output 4: 333 sats - Monitor fee
Output 5: 444 sats - Indexer fee
Output 6: 777 sats - Creator fee
Output 7: 888 sats - Foundation fee
Output 8: Change (if > 546 sats)API Endpoints Used
WhatsOnChain:
https://api.whatsonchain.com/v1/bsv/mainORDnet Registry:
https://registry.ordnet.ioORDnet Search:
https://search.ordnet.io
License
MIT © ORDnet.io / Mister HHC B.V.
Links
Website: https://ordnet.io
Documentation: https://docs.ordnet.io
GitHub: https://github.com/ordnet
Environment Variables (v2.4)
Variable | Required | Purpose |
| for wallet ops | Wallet private key (WIF). On HTTP transport this is the ONLY way to load a wallet. |
| no |
|
| no | HTTP port (default 3000). |
| yes, when TRANSPORT=http | Bearer token (min. 32 chars). Server refuses to start without it. Generate: |
| recommended on http | Operator hard ceiling per transaction. |
| recommended on http | Operator hard ceiling per server session. |
| no | Base URL of the ordnet-utxo index (default |
Known limitations
Wallet and spend-policy state are per server process, not per client session. Run the HTTP transport for a single trusted agent/team behind the auth token, not as a public multi-tenant service.
Balance and UTXO lookups use ORDnet's OWN address index (ordnet-utxo, port 7002, every UTXO node-verified) since v2.5; WhatsOnChain is a connectivity fallback only. New tools in v2.5:
ordnet_index_health,ordnet_address_watch.UTXO selection skips 1-sat UTXOs as ordinal protection and combines multiple inputs when needed.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityCmaintenanceA Bitcoin Ordinals MCP server with 24 tools covering inscriptions, runes, BRC-20 tokens, collections, rare sats, and marketplace data, aggregating Hiro, Ordiscan, and Magic Eden APIs with intelligent caching and automatic failover.482MIT

aibtc-mcp-serverofficial
Alicense-qualityAmaintenanceA Bitcoin-native MCP server for AI agents that provides 150+ tools for BTC and Stacks operations. Supports wallets, DeFi yield, sBTC peg, NFTs, and x402 payments.1,10910MIT- Flicense-qualityDmaintenanceMCP server enabling AI agents to participate in the Wisdom Network. Provides tools for knowledge management, trust relationships, and content transformation.
- AlicenseAqualityDmaintenanceMCP server for AI agent trust verification, enabling agents to verify identities, check trust scores, and build reputation across multiple blockchain and web platforms.1261MIT
Related MCP Connectors
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
Hosted AgentLux MCP server for marketplace, identity, creator, services, and social flows.
Native Solana staking for AI agents. 26 MCP tools, one-shot signing, webhooks.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ORDNET/ORDnet-MCP-Server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server