convez.ai
MCP ServerIntegração & APIsIntermediário
baeleb

seats-MCP

baeleb/seats-MCP

Busque prêmios aéreos em múltiplas companhias via IA, integrado ao Claude.

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que integra o Claude com a API de busca de passagens aéreas da seats.aero, permitindo agentes de IA consultar disponibilidade de prêmios em 20+ programas de milhas. Acesse cotações, custos em milhas e datas — direto do terminal ou editor, sem abrir navegador.

Instalação

$npx convez-ai baeleb/seats-MCP

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
v0.2.0
Issues abertas
1
Contribuidores
1

Casos de uso

  • Buscar assentos prêmio em múltiplos programas de milhas simultaneamente
  • Automatizar pesquisa de passagens para agentes de código
  • Consultar disponibilidade por rota, classe e data em tempo real

Veredito

Ferramenta bem estruturada para casos de uso específicos (viajantes, agentes de IA). Requer conta paga na seats.aero e respeita limites de taxa (1k req/dia). Implementação limpa em Go, documentação clara e multiplataforma. Nichos mas solução madura para quem já usa pontos aéreos.

README

A tradução para o português deste README ainda está na fila.

seats-MCP

Your coding agent now has frequent flyer status.

Ask your AI to find award flights — right from the terminal, inside your editor, or mid-refactor. seats-MCP connects AI coding agents to the seats.aero Partner API, giving them instant access to award availability across 20+ airline mileage programs.

Example: "Find me a business class seat from LAX to Tokyo on June 15th."

Your agent searches Aeroplan, United, Delta, Alaska, Emirates, and more — all in one call — and comes back with mileage costs, seat counts, airlines, and dates. No browser tabs. No point-and-click calendar hunting. Just ask.

Built on the Model Context Protocol. stdio transport.

Quickstart

1. Get an API key

You need a seats.aero account with a Pro or Commercial plan.

  1. Sign up at seats.aero and subscribe to Pro.
  2. Go to seats.aero/settings and open the API tab.
  3. Copy your API key. Keep this secret!

Note: seats.aero may limit API key access by geographical location or other criteria at their sole discretion. Pro keys are for non-commercial use only; commercial use requires a written agreement with seats.aero.

Rate limit: 1,000 requests/day shared across all uses of the key.

2. Get the binary

Option A — Download (recommended)

Go to Releases and download the binary for your platform, then make it executable:

chmod +x seats-mcp_darwin_arm64
PlatformFile
macOS Apple Siliconseats-mcp_darwin_arm64
macOS Intelseats-mcp_darwin_amd64
Linux x86_64seats-mcp_linux_amd64
Linux ARMseats-mcp_linux_arm64
Windows x86_64seats-mcp_windows_amd64.exe

Option B — Build from source

git clone https://github.com/baeleb/seats-MCP.git
cd seats-MCP
go build -o bin/seats-mcp .

Requires Go 1.26+.

3. Set your API key

Choose one method to make the key available at runtime:

Option A — Shell profile (persistent, simplest)

Add this line to ~/.zshrc (or ~/.bashrc):

export SEATS_AERO_API_KEY="your-partner-api-key"

Then restart your shell or run source ~/.zshrc.

Option B — Inline per-command

SEATS_AERO_API_KEY="your-key" ./bin/seats-mcp

4. Add to your MCP client

OpenCode

Add to ~/.config/opencode/opencode.jsonc:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "seats-aero": {
      "type": "local",
      "command": ["/path/to/seats-MCP/bin/seats-mcp"],
      "enabled": true,
      "environment": {
        "SEATS_AERO_API_KEY": "{env:SEATS_AERO_API_KEY}"
      }
    }
  }
}

Use an absolute path to the binary. The {env:SEATS_AERO_API_KEY} syntax pulls the value from your shell environment — no secret written to the config file.

Restart OpenCode. The four tools below will appear under the seats-aero_ prefix.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "seats-aero": {
      "command": "/absolute/path/to/seats-MCP/bin/seats-mcp",
      "env": {
        "SEATS_AERO_API_KEY": "your-partner-api-key"
      }
    }
  }
}

Claude Code

Add to your Claude Code MCP config:

{
  "mcpServers": {
    "seats-aero": {
      "command": "/absolute/path/to/seats-MCP/bin/seats-mcp",
      "env": {
        "SEATS_AERO_API_KEY": "your-partner-api-key"
      }
    }
  }
}

MCP Inspector (manual testing)

SEATS_AERO_API_KEY="your-key" npx @modelcontextprotocol/inspector ./bin/seats-mcp

Tools

ToolEndpointUse for
search_award_availabilityGET /searchCached, multi-program search by route + date range. Fast.
bulk_availabilityGET /availabilitySingle-program bulk fetch, paginated. Explore-style queries.
get_tripsGET /trips/{id}Drill into a specific Availability for flight-level itineraries.
live_searchPOST /liveReal-time search for one route/date/program. Slower (5-15s).

Notes

  • Live search is not available to Pro users. The /live endpoint requires a commercial agreement with seats.aero. If you are a Pro user, the live_search tool will return errors.
  • IDs returned by live_search are ephemeral and cannot be passed to get_trips.
  • Times in responses use the local airport timezone, not UTC.
  • Not all mileage programs report seat counts or trip-level data — treat capability gaps as expected.
  • The server logs only to stderr (stdout is the MCP transport).

See CLAUDE.md for the full API surface reference.

License

GPLv3. See LICENSE.

Ver o original no GitHub

Bom para

Relacionados