MCP server for interacting with the Ordiscan API to query Bitcoin ordinals and inscriptions. Requires an Ordiscan API key.
An MCP Framework HTTP server implementation with Ordiscan API integration.
All tools connect directly to the Ordiscan API (api.ordiscan.com
) without requiring any proxy. This ensures:
Every tool requires authentication using a Bearer token:
apiKey
parameter)ORDISCAN_API_KEY
environment variableAuthorization: Bearer <your-api-key>
headernpm install
npm run build
{
"mcpServers": {
"ordiscanmcpv1": {
"command": "npx",
"args": [
"mcp-remote",
"https://your-deployed-server.com/mcp"
]
}
}
}
url: (http://localhost:1337/mcp) Remote: (https://ordiscan-mcp-v1.onrender.com/mcp)
npm start
For development with hot-reload:
npm run dev
Pass in the key with a request one time, good to go.
ordiscanmcpv1/
├── src/
│ ├── tools/
│ │ ├── ordiscan-utils.ts
│ │ ├── ordiscan.ts # Main Ordiscan Tool
│ │ │
│ │ ├── # Address Tools
│ │ ├── ordiscan-utxo.ts
│ │ ├── ordiscan-inscriptions.ts
│ │ ├── ordiscan-inscriptions-detail.ts
│ │ ├── ordiscan-runes-balance.ts
│ │ ├── ordiscan-brc20-balance.ts
│ │ ├── ordiscan-rare-sats.ts
│ │ │
│ │ ├── # Activity Tools
│ │ ├── ordiscan-inscriptions-activity.ts
│ │ ├── ordiscan-runes-activity.ts
│ │ ├── ordiscan-brc20-activity.ts
│ │ │
│ │ ├── # Transaction Tools
│ │ ├── ordiscan-tx-info.ts
│ │ ├── ordiscan-tx-inscriptions.ts
│ │ ├── ordiscan-tx-inscription-transfers.ts
│ │ ├── ordiscan-tx-runes.ts
│ │ │
│ │ ├── # Inscription Tools
│ │ ├── ordiscan-inscription-info.ts
│ │ ├── ordiscan-inscription-traits.ts
│ │ ├── ordiscan-inscriptions-list.ts
│ │ ├── ordiscan-inscriptions-detail.ts
│ │ │
│ │ ├── # Collection Tools
│ │ ├── ordiscan-collections-list.ts
│ │ ├── ordiscan-collection-info.ts
│ │ ├── ordiscan-collection-inscriptions.ts
│ │ │
│ │ ├── # Rune Tools
│ │ ├── ordiscan-runes-list.ts
│ │ ├── ordiscan-rune-market.ts
│ │ ├── ordiscan-rune-name-unlock.ts
│ │ │
│ │ ├── # BRC-20 Tools
│ │ ├── ordiscan-brc20-list.ts
│ │ ├── ordiscan-brc20-info.ts
│ │ │
│ │ ├── # Sat Tools
│ │ ├── ordiscan-sat-info.ts
│ │ ├── ordiscan-utxo-rare-sats.ts
│ │ └── ordiscan-utxo-sat-ranges.ts
│ │
│ └── index.ts
├── package.json
├── tsconfig.json
└── README.md
All tools use robust parameter handling utilities from ordiscan-utils.ts
:
flexibleNumber()
: Accepts both string and number inputs for numeric parameters
flexibleEnum()
: Validates string inputs against predefined values
These utilities ensure consistent parameter handling across all tools while maintaining type safety and validation.
Get detailed information about a specific inscription.
Tool Name: ordiscan_inscription_info
Parameters:
id
(string): The inscription ID (e.g. b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0)apiKey
(string, optional): Your Ordiscan API keyExample Response:
{
"success": true,
"formatted": {
"id": "b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0",
"number": 123456,
"type": "image/png",
"timestamp": "2024-01-01 12:00:00",
"sat": "1,234,567",
"content_url": "https://ordinals.com/content/...",
"collection": "example-collection",
"owner": {
"address": "bc1...",
"output": "txid:vout"
},
"genesis": {
"address": "bc1...",
"output": "txid:vout"
}
}
}
Get market information for a specific rune.
Tool Name: ordiscan_rune_market
Parameters:
name
(string): The unique name of the rune (without spacers)apiKey
(string, optional): Your Ordiscan API keyExample Response:
{
"success": true,
"formatted": {
"price": {
"sats": "1,234.56",
"usd": "$0.50"
},
"market_cap": {
"btc": "12.3456",
"usd": "$500,000"
}
}
}
Get detailed information about a BRC-20 token.
Tool Name: ordiscan_brc20_info
Parameters:
tick
(string): The unique tick of the tokenapiKey
(string, optional): Your Ordiscan API keyExample Response:
{
"success": true,
"formatted": {
"tick": "ORDI",
"supply": {
"max": "21,000,000",
"minted": "15,000,000",
"remaining": "6,000,000",
"percent_minted": "71.43%"
},
"market": {
"price_usd": "$1.23",
"market_cap_usd": "$18,450,000",
"fully_diluted_market_cap_usd": "$25,830,000"
}
}
}
All tools include comprehensive error handling:
Each tool provides both raw and formatted responses:
data
fieldformatted
fieldThe server implements secure error handling:
All tools use strict input validation:
Rate limiting is handled by the Ordiscan API:
An MCP server for expert discovery, registration, and context injection, utilizing vector and graph databases.
Provides real-time Caltrain schedule information using GTFS data.
Search code across millions of public GitHub repositories using the grep.app API.
Interacting with Perplexity
Query and analyze Portuguese companies using the NIF.PT public API. Supports search by NIF, company name, and city.
Vectorize MCP server for advanced retrieval, Private Deep Research, Anything-to-Markdown file extraction and text chunking.
Provides threat intelligence queries for IPs, domains, files, URLs, and vulnerabilities using the ThreatBook API.
Extracts basic chemical information about drugs and compounds from the PubChem API.
Converts QuantConnect PDF documentation into searchable markdown, enabling fast, context-aware search.
Search for npm packages