Synth MCP

Accede a datos financieros como precios de acciones, información de divisas y datos de operaciones con información privilegiada mediante la API de Synth Finance.

GitHub
2
Prueba este MCPPatrocinado

Documentación

Synth MCP

Un servidor MCP (Protocolo de Contexto de Modelo) remoto que proporciona a los asistentes de IA acceso a la API de Synth Finance. Este servidor permite a Claude Desktop y otros clientes compatibles con MCP acceder a datos financieros, información de divisas, precios de acciones, datos de operaciones de información privilegiada y más a través de consultas en lenguaje natural.

Características

  • 🏦 Enriquecimiento de Transacciones: Decodifica transacciones bancarias crípticas en información clara del comerciante con logotipos, ubicaciones y categorías
  • 💱 Tipos de Cambio de Divisas: Accede a tipos de cambio en tiempo real e históricos para todas las principales divisas
  • 📈 Datos del Mercado de Valores: Busca tickers y recupera datos históricos de precios OHLC
  • 👔 Datos de Operaciones de Información Privilegiada: Accede a presentaciones completas del Formulario 4 de la SEC y actividad de operaciones ejecutivas
  • 👤 Información de Cuenta de Usuario: Consulta el uso de la API, créditos restantes y detalles de la cuenta

Inicio Rápido

Para Usuarios

Simplemente añade esto a tu configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "synth": {
      "url": "https://mcp.synthfinance.com/sse",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_SYNTH_API_KEY"
      }
    }
  }
}

Obtén tu clave API en synthfinance.com.

Herramientas Disponibles

💳 enrichTransaction

Decodifica transacciones bancarias y de tarjetas de crédito crípticas en información significativa del comerciante.

Consultas de ejemplo:

  • "¿Qué es este cargo: SQ *COFFEE SHOP 4155551234?"
  • "Decodifica TST* NOMBRE DEL COMERCIANTE 123"
  • "Identifica esta transacción: WM SUPERCENTER #1234"

💵 getLiveRates

Obtén tipos de cambio de divisas en tiempo real (actualizados cada 60 segundos).

Consultas de ejemplo:

  • "¿Cuál es el tipo de cambio actual de USD a EUR?"
  • "Convierte 100 dólares a euros"
  • "Obtén tipos de cambio forex en vivo para las principales divisas"

📊 getHistoricalRates

Obtén tipos de cambio históricos para cualquier fecha pasada.

Consultas de ejemplo:

  • "¿Cuál fue el tipo de cambio de USD a EUR el 1 de enero de 2023?"
  • "Obtén tipos de cambio del mes pasado"
  • "Tipo de cambio histórico EUR/USD para fines fiscales"

🔍 searchTickers

Busca tickers de acciones por nombre de empresa o símbolo.

Consultas de ejemplo:

  • "Encuentra el ticker de Apple"
  • "¿Cuál es el símbolo bursátil de Microsoft?"
  • "Busca acciones de energía renovable"

📈 getOpenClosePrices

Obtén datos históricos de precios de acciones (OHLC) para cualquier rango de fechas.

Consultas de ejemplo:

  • "Obtén precios de acciones de AAPL para enero de 2024"
  • "Muéstrame el historial de precios de Tesla del último trimestre"
  • "Datos OHLC para NVDA desde 2023"

👔 getInsiderTrades

Accede a la actividad de operaciones de información privilegiada y presentaciones del Formulario 4 de la SEC.

Consultas de ejemplo:

  • "Muestra operaciones de información privilegiada para AAPL"
  • "Actividad reciente de información privilegiada para Tesla"
  • "¿Qué ejecutivos están comprando MSFT?"

👤 getUserInfo

Obtén información de tu cuenta de Synth y uso de la API.

Consultas de ejemplo:

  • "Muestra mi información de cuenta"
  • "¿Cuántos créditos de API me quedan?"
  • "Consulta mi uso de la API"

Descubrimiento Mejorado de Herramientas

Este servidor MCP incluye una optimización extensa de palabras clave para garantizar que las herramientas se activen adecuadamente. Cada herramienta responde a cientos de términos relacionados y patrones de lenguaje natural, lo que hace más probable que tus consultas utilicen la API de Synth en lugar de la búsqueda web.

Autoalojamiento

Desplegar en Railway (Recomendado)

  1. Empuja a GitHub:

    git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/yourusername/synth-mcp.git
git push -u origin main

  2. Despliega en Railway:

    • Ve a railway.app
    • Haz clic en "Nuevo Proyecto" → "Desplegar desde GitHub"
    • Selecciona tu repositorio
    • ¡Railway se despliega automáticamente!

  3. Añade un Dominio Personalizado:

    • En Railway: Configuración → Redes → Añade tu dominio
    • En tu DNS: Añade un registro CNAME que apunte a Railway

Desplegar con Docker

docker build -t synth-mcp .
docker run -p 3000:3000 synth-mcp

Desplegar en Heroku

heroku create your-synth-mcp
git push heroku main

Endpoints de la API

  • GET /health - Endpoint de verificación de salud
  • GET /sse - Endpoint SSE para comunicación MCP
  • POST /message - Endpoint de manejo de mensajes

Seguridad

  • Las claves API se pasan a través de encabezados y nunca se almacenan en el servidor
  • Cada usuario proporciona su propia clave API de Synth
  • Utiliza siempre HTTPS en producción
  • CORS está configurado para acceso seguro entre orígenes

Desarrollo

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Start production server
npm start

Variables de Entorno

  • PORT - Puerto del servidor (predeterminado: 3000, configurado automáticamente por la mayoría de las plataformas de alojamiento)

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (Pull Request).

Licencia

ISC

Soporte

Construido con ❤️ por Synth Finance