Kirah Local Services
oficialDescubra negócios Kirah, navegue pelos serviços publicados e verifique a disponibilidade atual por meio de um servidor MCP seguro e somente leitura.
O que você pode fazer com Kirah Local Services MCP?
- Descubra serviços locais — Peça ao seu assistente para encontrar uma empresa que ofereça um serviço específico, como massagem de cadeira em Columbus, com preço e disponibilidade reais por meio do endpoint público do plugin.
- Verifique vagas atuais — Solicite a disponibilidade atual de um serviço e veja se uma empresa tem um horário que se encaixa na sua agenda, usando o endpoint MCP com capacidade de reserva.
- Solicite um agendamento — Peça ao seu assistente para reservar um serviço pelo endpoint MCP, que pode aguardar a aprovação do proprietário quando a empresa usa o modo "Aprovar primeiro".
- Revise as políticas da empresa — Pergunte sobre depósitos, regras de cancelamento ou limites de taxa que o servidor aplica para uma determinada empresa antes de se comprometer com uma reserva.
Documentação
Deixe os clientes encontrarem seus serviços com IA
Por que isso existe
As pessoas cada vez mais perguntam ao seu assistente, não a uma barra de busca. O cliente que precisa de massagem profunda hoje entre 14h e 16h não deveria clicar por cinco telas para descobrir que o horário não funciona—e o profissional com exatamente essa vaga não deveria ficar invisível para a pergunta. Kirah é a conexão: sem esforço para o cliente perguntar, sem esforço para o profissional ser encontrado. A história completa →
Como isso funciona para um cliente
No ChatGPT: Um cliente pede massagem de cadeira em Columbus e vê o serviço real, o preço e o horário de um negócio participante. O cliente então agenda fora do ChatGPT porque o plugin público não cria compromissos.
No Claude ou Grok: Um cliente faz a mesma pergunta, vê o serviço, o preço e o horário real, e então solicita o agendamento. Se o negócio usa o modo Approve primeiro, o proprietário aprova a solicitação e o cliente recebe a confirmação.
Como funciona
Para desenvolvedores e criadores de agentes
Plugin público do ChatGPT: https://kirah.ai/api/mcp-directory-v1\ — uma superfície informativa limitada à descoberta de negócios e serviços, além da disponibilidade atual. Não coleta detalhes de reserva nem altera compromissos.
Endpoint MCP com capacidade de reserva: https://kirah.ai/api/mcp\ — Streamable HTTP sem estado para conexões compatíveis, com ferramentas que cobrem desde a descoberta até o cancelamento seguro. Introspecção ao vivo em /api/mcp-info\. O Claude usa seu conector dedicado documentado em /claude-connector.html\.
Contrato OpenAPI: /.well-known/kirah-gateway.openapi.json\ — versionado, com um envelope de resposta total (toda resposta carrega um outcome\) e limites de taxa em camadas que nunca cobram uma solicitação malformada contra o orçamento de reservas.
Manifestos por negócio: /.well-known/kirah.json\ em domínios de locatários, com cabeçalhos Link: rel="service-desc"\ em locatários hospedados por caminho—para que até um curl\ bruto sem JavaScript encontre o manifesto.
A parte que importa para os proprietários
Opt-in, por negócio
A descoberta por agentes de IA fica desativada até você ativá-la. Seu negócio nunca é exposto a agentes por padrão.
O modo de aprovação se aplica a agentes com capacidade de reserva
Uma solicitação de reserva do Claude ou Grok aguarda seu sim exatamente como uma solicitação do seu próprio site. Nada é confirmado sem você quando o Approve primeiro está ativado.
As regras são aplicadas pelo servidor
Depósitos, políticas e limites de taxa são aplicados onde o modelo não pode sobrescrevê-los. O log de auditoria é somente de acréscimo.
Dados privados permanecem no escopo do locatário
Catálogos públicos de serviços permanecem descobríveis, enquanto dados privados de reserva e tokens de capacidade são limitados a um único negócio. O servidor rejeita reservas inelegíveis e tentativas de burlar as regras.