agenda de feiras

Assistentes de IA

Conectar a Agenda de Feiras

Assinantes do plano Anual consultam as feiras publicadas pelo Claude, pelo ChatGPT ou pelo Cursor. O plano de 30 dias recebe 403 com o link para assinar. O assistente só lê. Ele não publica feira, não exporta a base e não vê rascunho.

Endereço do servidor MCP: https://agendadefeiras.com.br/mcp

A REST fica em https://agendadefeiras.com.br/api/v1. A especificação OpenAPI 3.1 está em /api/v1/openapi.json. O contrato dos campos é o 2.4.0: id público, datas ISO e paginação por next_cursor.

Quem entra

  • Anual: 60 chamadas por minuto, 500 registros por dia, 50 por página, 50 contatos por dia e 1 aplicativo OAuth.
  • 30 dias: sem MCP e sem API. A resposta pede o upgrade em /planos#anual.

Cada chamada devolve RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset. No estouro, a REST responde 429 e o MCP devolve o erro JSON-RPC -32002.

Claude

No Claude Desktop ou na web, abra Configurações, depois Conectores, e adicione um conector remoto. Cole o endereço do servidor. O Claude abre o navegador neste site para o login e o consentimento. Não use um comando local.

Nome: Agenda de Feiras
URL: https://agendadefeiras.com.br/mcp

ChatGPT

Em Configurações, abra Apps e conectores, crie um conector remoto e cole o mesmo endereço. Quando o ChatGPT pedir, entre com a conta da Agenda de Feiras e autorize a leitura.

Conector remoto
https://agendadefeiras.com.br/mcp

Cursor

Em Cursor Settings, MCP, adicione um servidor pelo URL. O Cursor pede a autorização no navegador e guarda o acesso na máquina. O mesmo bloco vale em mcp.json.

{
  "mcpServers": {
    "agenda-de-feiras": {
      "url": "https://agendadefeiras.com.br/mcp"
    }
  }
}

O que dá para perguntar

  • Quais feiras de alimentos acontecem em São Paulo em março de 2027?
  • O que mudou desde 1º de outubro de 2026?
  • Quais os valores de nivel_verificacao, incluindo calendario_governo?

A busca aceita updated_since para sincronizar só o que mudou. Filtros de taxonomia (público, setor, subsetor, tags, porte, gratuita, tipo de evento, recorrência, internacional, ambiente, público-alvo, acessibilidade, pet friendly e nível de verificação) entram quando a base tiver essas colunas. Antes disso, o filtro é ignorado. A ferramenta listar_taxonomia e GET /api/v1/taxonomia listam os valores.

REST com OAuth

O token OAuth desta conexão vale na REST. O escopo é só leitura. Não há rota de exportação: peça uma página e siga o next_cursor.

curl -H "Authorization: Bearer …" \
  "https://agendadefeiras.com.br/api/v1/feiras?uf=SP&updated_since=2026-10-01T00:00:00-03:00&limite=50"

Conta

Os apps ficam em Apps conectados. O aviso de feira nova ou alterada, com assinatura HMAC e novas tentativas, fica em Webhooks. A entrega só começa quando a equipe ligar o recurso.