@unisat/openapi-mcp
v1.0.0
Published
UniSat AI Kit MCP server
Maintainers
Readme
@unisat/openapi-mcp
This package exposes the UniSat AI Kit MCP server.
Requires Node.js ^22.23.4 || ^24.22.1 || ^26.12.1 and npm. Install globally:
npm install -g @unisat/openapi-mcpOr run it without a global install:
npx -y @unisat/openapi-mcpThe server downloads Swagger on startup and uses its local cache. Configure OPENAPI_SWAGGER_DIR to use local definitions instead.
Tools
get_status: return server, CLI, swagger, and config status.list_operations: discover interfaces by query/domain with bounded pagination.get_operation: inspect parameters and safety metadata.call_api: call an exact UniSat OpenAPI path.
Use the built-in discovery tools before call_api; an Agent Skill is not required. Configure this command as a stdio MCP server in your agent client. Obtain a key at https://developer.unisat.io/ and supply UNISAT_BITCOIN_API_KEY in the server process environment. See the setup guide for configuration examples.
First test: latest Bitcoin block height
Ask your agent to discover the blockchain info interface, inspect it, and call it read-only. The call_api arguments are:
{
"path": "/v1/indexer/blockchain/info",
"environment": "bitcoin"
}Read structuredContent.response.body.data.blocks. Check isError, response.ok and the business code before treating the call as successful. No address, wallet or confirmation is needed. For Fractal, configure UNISAT_FRACTAL_API_KEY separately and use environment: "fractal"; both networks are mainnets.
Result format
Tool results return both:
content: serialized JSON text.structuredContent: structured object payload.
Local development
node bin/server.js