Synth MCP

Acesse dados financeiros como preços de ações, informações de moedas e dados de negociação com informações privilegiadas usando a API Synth Finance.

GitHub
2
Experimente este MCPPatrocinado

Documentação

Synth MCP

Um servidor MCP (Model Context Protocol) remoto que fornece aos assistentes de IA acesso à API Synth Finance. Este servidor permite que o Claude Desktop e outros clientes compatíveis com MCP acessem dados financeiros, informações de moedas, preços de ações, dados de negociação de insiders e muito mais por meio de consultas em linguagem natural.

Recursos

  • 🏦 Enriquecimento de Transações: Decodifique transações bancárias enigmáticas em informações claras de comerciantes com logotipos, locais e categorias
  • 💱 Taxas de Câmbio: Acesse taxas de câmbio em tempo real e históricas para todas as principais moedas
  • 📈 Dados do Mercado de Ações: Pesquise tickers e recupere dados históricos de preços OHLC
  • 👔 Dados de Negociação de Insiders: Acesse arquivamentos abrangentes do SEC Form 4 e atividade de negociação de executivos
  • 👤 Informações da Conta do Usuário: Verifique o uso da API, créditos restantes e detalhes da conta

Início Rápido

Para Usuários

Basta adicionar isto à sua configuração do 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"
      }
    }
  }
}

Obtenha sua chave de API em synthfinance.com.

Ferramentas Disponíveis

💳 enrichTransaction

Decodifique transações bancárias e de cartão de crédito enigmáticas em informações significativas de comerciantes.

Exemplos de consultas:

  • "O que é esta cobrança: SQ *COFFEE SHOP 4155551234"
  • "Decodifique TST* MERCHANT NAME 123"
  • "Identifique esta transação: WM SUPERCENTER #1234"

💵 getLiveRates

Obtenha taxas de câmbio em tempo real (atualizadas a cada 60 segundos).

Exemplos de consultas:

  • "Qual é a taxa de câmbio atual de USD para EUR?"
  • "Converta 100 dólares em euros"
  • "Obtenha taxas forex ao vivo para as principais moedas"

📊 getHistoricalRates

Obtenha taxas de câmbio históricas para qualquer data passada.

Exemplos de consultas:

  • "Qual foi a taxa de USD para EUR em 1º de janeiro de 2023?"
  • "Obtenha taxas de câmbio do mês passado"
  • "Taxa histórica de EUR/USD para fins fiscais"

🔍 searchTickers

Pesquise tickers de ações por nome da empresa ou símbolo.

Exemplos de consultas:

  • "Encontre o ticker da Apple"
  • "Qual é o símbolo da ação da Microsoft?"
  • "Pesquise ações de energia renovável"

📈 getOpenClosePrices

Obtenha dados históricos de preços de ações (OHLC) para qualquer intervalo de datas.

Exemplos de consultas:

  • "Obtenha os preços das ações da AAPL para janeiro de 2024"
  • "Mostre-me o histórico de preços da Tesla no último trimestre"
  • "Dados OHLC para NVDA desde 2023"

👔 getInsiderTrades

Acesse a atividade de negociação de insiders e os arquivamentos do SEC Form 4.

Exemplos de consultas:

  • "Mostre negociações de insiders para AAPL"
  • "Atividade recente de insiders da Tesla"
  • "Quais executivos estão comprando MSFT?"

👤 getUserInfo

Obtenha informações da sua conta Synth e uso da API.

Exemplos de consultas:

  • "Mostre minhas informações de conta"
  • "Quantos créditos de API ainda tenho?"
  • "Verifique meu uso da API"

Descoberta Aprimorada de Ferramentas

Este servidor MCP inclui otimização extensiva de palavras-chave para garantir que as ferramentas sejam acionadas adequadamente. Cada ferramenta responde a centenas de termos relacionados e padrões de linguagem natural, tornando mais provável que suas consultas usem a API Synth em vez de pesquisa na web.

Auto-hospedagem

Implantar no Railway (Recomendado)

  1. Envie para o 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. Implante no Railway:

    • Acesse railway.app
    • Clique em "New Project" → "Deploy from GitHub"
    • Selecione seu repositório
    • O Railway implanta automaticamente!

  3. Adicione um Domínio Personalizado:

    • No Railway: Settings → Networking → Adicione seu domínio
    • No seu DNS: Adicione um registro CNAME apontando para o Railway

Implantar com Docker

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

Implantar no Heroku

heroku create your-synth-mcp
git push heroku main

Endpoints da API

  • GET /health - Endpoint de verificação de saúde
  • GET /sse - Endpoint SSE para comunicação MCP
  • POST /message - Endpoint de manipulação de mensagens

Segurança

  • As chaves de API são transmitidas por cabeçalhos e nunca armazenadas no servidor
  • Cada usuário fornece sua própria chave de API Synth
  • Sempre use HTTPS em produção
  • CORS está configurado para acesso seguro entre origens

Desenvolvimento

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Start production server
npm start

Variáveis de Ambiente

  • PORT - Porta do servidor (padrão: 3000, definida automaticamente pela maioria das plataformas de hospedagem)

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

ISC

Suporte

Feito com ❤️ por Synth Finance