braiins-api-mapper

Map Braiins Pool API endpoints to MCP tool implementations with standardized authentication and retry patterns.

Updated Nov 29, 2025
One-click install
npx skills add https://github.com/Ryno-Crypto-Mining-Services/braiins-pool-mcp-server --skill braiins-api-mapper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: braiins-api-mapper
Source: https://github.com/Ryno-Crypto-Mining-Services/braiins-pool-mcp-server/tree/main/.claude/skills/braiins-api-mapper
Command: npx skills add https://github.com/Ryno-Crypto-Mining-Services/braiins-pool-mcp-server --skill braiins-api-mapper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured approach to map Braiins Pool API endpoints to MCP tool implementations, ensuring consistent authentication, rate limiting, and robust error handling across endpoints.

Core Features & Use Cases

  • Mapping endpoints from Braiins API to MCP tool methods with clear patterns for request construction, auth, and response normalization.
  • Enforcing retry and backoff strategies to handle transient failures while avoiding unnecessary requests on client errors.
  • Use Case: When adding a new Braiins API endpoint, generate a type-safe client method (e.g., getWorkerDetails) and integrate it into the MCP tool suite according to ARCHITECTURE.md.

Quick Start

Create a BraiinsApiClient scaffold that uses BRAIINS_API_BASE_URL and BRAIINS_POOL_API_TOKEN, implements a generic request method with retry logic, and adds endpoint methods such as getUserOverview and listWorkers following the patterns in ARCHITECTURE.md.

Frequently Asked Questions about braiins-api-mapper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map Braiins Pool API endpoints to MCP tool methods in TypeScript?

Map Braiins Pool API endpoints to MCP tool methods by creating a BraiinsApiClient scaffold that implements generic request handling with standardized authentication, retry logic, and response normalization for each endpoint.

What environment variables do I need to configure for Braiins API authentication?

Braiins API authentication requires configuring two environment variables: BRAIINS_API_BASE_URL for the base URL and BRAIINS_POOL_API_TOKEN for the authentication token, both consumed by the TypeScript HTTP client.

How does retry and rate limiting work when integrating Braiins API endpoints?

Retry and rate limiting for Braiins API endpoints enforce backoff strategies to handle transient failures while avoiding unnecessary requests on client errors, ensuring consistent response shaping across all mapped endpoints.

Can I extend the Braiins API client to add new MCP endpoints like getWorkerDetails?

Extend the Braiins API client by adding type-safe endpoint methods such as getWorkerDetails or listWorkers following standardized mapping patterns, integrating each new method into the MCP tool suite with consistent auth and error handling.

Do I need a specific runtime environment to use the Braiins API MCP mapper?

Using the Braiins API MCP mapper requires a TypeScript environment and an HTTP client, plus configured environment variables for the base URL and API token to establish authentication and route requests.

What problem does standardized response shaping solve for Braiins API integration?

Standardized response shaping solves inconsistent API behavior by normalizing Braiins Pool endpoint outputs into uniform MCP tool responses, applying shared authentication and error handling patterns across all endpoint methods.