mcp-server-skyfire

What is mcp-server-skyfire?

A Model Context Protocol (MCP) server that interfaces with the Skyfire payment system. It exposes a single tool, make_payment, enabling AI models to initiate payments to Skyfire users through a standardized protocol.

How to use mcp-server-skyfire?

Clone the repository, install dependencies with npm install, then create a .env file in the root directory with your Skyfire API key as SKYFIRE_API_KEY. Build the project with npm run build, then run the server via ./build/index.js or the npm binary mcp-server-skyfire. The server communicates over stdio and accepts the make_payment tool with receiverUsername (string) and amount (string) parameters.

Key features of mcp-server-skyfire

• Exposes one tool: make_payment
• Makes payments to a specified Skyfire user
• Runs over standard input/output (stdio)
• Returns structured JSON responses on success
• Implements error handling for invalid tool names, missing parameters, and payment failures

Use cases of mcp-server-skyfire

• AI models autonomously making payments via the Skyfire system
• Automating micro-payments in AI-driven workflows
• Integrating Skyfire payment capabilities into MCP-compatible clients

FAQ from mcp-server-skyfire

What authentication is required?

A valid Skyfire API key stored in a .env file under the variable SKYFIRE_API_KEY.

What transport does the server use?

The server runs on standard input/output (stdio).

What parameters does the make_payment tool require?

The tool requires receiverUsername (string) and amount (string). The response confirms the payment sent.

What error types are returned?

Invalid tool name returns MethodNotFound, missing or invalid parameters return InvalidParams, and payment processing failures return InternalError.

What are the main dependencies?

Node.js (ES2022 compatible), TypeScript, and the npm packages @modelcontextprotocol/sdk ^1.0.3, @skyfire-xyz/skyfire-sdk ^0.8.5, dotenv ^16.4.7, and zod ^3.24.1.