mcp-server-skyfire

A Model Context Protocol (MCP) server implementation that interfaces with the Skyfire payment system. This server enables AI models to make payments through Skyfire's infrastructure using a standardized protocol.

Overview

This server implements the Model Context Protocol to provide payment functionality via Skyfire's API. It exposes a single tool, make_payment, which allows authorized clients to initiate payments to Skyfire users.

Prerequisites

• Node.js (ES2022 compatible)
• TypeScript
• A valid Skyfire API key

Installation

1. Clone the repository:

git clone <repository-url>
cd mcp-server-skyfire

2. Install dependencies:

npm install

3. Create a .env file in the root directory and add your Skyfire API key:

SKYFIRE_API_KEY=your_api_key_here

Building

To build the project:

npm run build

This will:

• Compile TypeScript to JavaScript
• Make the output file executable
• Place the built files in the ./build directory

Features

The server exposes one tool through the MCP interface:

make_payment

Makes a payment to a specified Skyfire user.

Parameters:

• receiverUsername (string): The username of the payment recipient
• amount (string): The payment amount

Example Response:

{
  "content": [
    {
      "type": "text",
      "text": "Payment of [amount] successfully sent to [username]"
    }
  ]
}

Error Handling

The server implements comprehensive error handling for various scenarios:

• Invalid tool name: Returns MethodNotFound error
• Missing or invalid parameters: Returns InvalidParams error
• Payment processing failures: Returns InternalError error

Dependencies

Main dependencies include:

• @modelcontextprotocol/sdk: ^1.0.3
• @skyfire-xyz/skyfire-sdk: ^0.8.5
• dotenv: ^16.4.7
• zod: ^3.24.1

Development

The project is set up with TypeScript and includes:

• Strict type checking
• ES2022 target
• Node16 module resolution
• Consistent file casing enforcement

Running the Server

The server runs on standard input/output (stdio). After building, you can run it using:

./build/index.js

Or through the npm binary:

mcp-server-skyfire