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
- 01Receive MCP requests as JSON
- 02Route requests by tool choice
- 03Retrieve current cryptocurrency prices
- 04Get general cryptocurrency information
- 05Fetch price history
Use cases
- 01Check a cryptocurrency's current price
- 02Retrieve basic coin information
- 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.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEMCPServer + 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?
- Un agente (como Claude o GPT) hace una consulta MCP.
webhook.phpdelmcpserverla recibe y decide qué tool usar.- Si es sobre criptomonedas, llama al wrapper TypeScript (
mcp-coingecko-wrapper). - Se obtiene la respuesta de CoinGecko y se devuelve en formato MCP.
Requisitos
- PHP 8+ con soporte para
curl(paramcpserver). - 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
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.