mcpField
M
MCPServer + CoinGecko Wrapper

MCPServer + CoinGecko Wrapper

Local
github.com/unsimpledevDeveloper Tools0Updated 78w ago

About MCPServer + CoinGecko Wrapper

MCPServer + CoinGecko Wrapper combines a PHP MCP request handler with a Node.js and TypeScript wrapper for CoinGecko. It lets compatible agents request cryptocurrency prices, general information, and price history.

Key features

  1. 01Receive MCP requests as JSON
  2. 02Route requests by tool choice
  3. 03Retrieve current cryptocurrency prices
  4. 04Get general cryptocurrency information
  5. 05Fetch price history

Use cases

  1. 01Check a cryptocurrency's current price
  2. 02Retrieve basic coin information
  3. 03Review historical price data

MCP support

The PHP server receives MCP requests and returns structured MCP responses. It routes cryptocurrency requests to the HTTP-compatible CoinGecko wrapper, which exposes price, information, and history operations.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MCPServer + CoinGecko Wrapper

Este repositorio contiene dos componentes clave para trabajar con Model Context Protocol (MCP):


1. mcpserver (PHP)

Servidor principal que recibe y responde peticiones MCP desde agentes compatibles.

Archivos principales:
  • core/: lógica central reutilizable.
  • capabilities.php: declara qué herramientas (tools) puede usar este servidor.
  • webhook.php: endpoint principal que recibe las requests MCP.
Qué hace?
  • Recibe solicitudes en formato MCP (JSON).
  • Redirige internamente según el tool_choice.
  • Llama a la herramienta correspondiente (por ejemplo, el wrapper de CoinGecko).
  • Devuelve una respuesta estructurada MCP para que la procese el agente.

2. mcp-coingecko-wrapper (Node.js + TypeScript)

Tool externa que expone datos de criptomonedas usando la API pública de CoinGecko.

Estructura:
  • src/index.ts: lógica principal del wrapper.
  • package.json: scripts y dependencias.
Qué hace?
  • Expone un endpoint HTTP compatible con MCP.
  • Permite obtener datos como:
    • Precio actual de una criptomoneda.
    • Información general.
    • Historial de precios.

Cómo funciona todo junto?

  1. Un agente (como Claude o GPT) hace una consulta MCP.
  2. webhook.php del mcpserver la recibe y decide qué tool usar.
  3. Si es sobre criptomonedas, llama al wrapper TypeScript (mcp-coingecko-wrapper).
  4. Se obtiene la respuesta de CoinGecko y se devuelve en formato MCP.

Requisitos

  • PHP 8+ con soporte para curl (para mcpserver).
  • Node.js 18+ (para el wrapper).
  • Una instancia de agente compatible con MCP (ej: Claude).

Instalación rápida

# 1. Instalar dependencias del wrapper
cd mcp-coingecko-wrapper
npm install
npm run build
# 2. Servir el mcpserver (PHP)
# Usar XAMPP, Apache o cualquier servidor PHP con acceso a webhook.php

馃摤 Ejemplo de request MCP

{
  "tool_choice": "coingecko",
  "input": {
    "symbol": "bitcoin",
    "operation": "price_now"
  }
}

Listo. Es todo lo que necesit谩s para conectar un agente con CoinGecko usando MCP.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.