Subastech — Spanish judicial property auctions (BOE)

npx add-mcp 'https://mcp.subastech.com/mcp'

Conecte sua IA à Subastech

Fonte: BOE · Subastech · Canônica: https://app.subastech.com/agentes

A Subastech oferece a qualquer assistente de IA (Claude, ChatGPT, Claude Code, Cursor ou outros clientes MCP) e a agentes A2A acesso aos leilões judiciais de imóveis do BOE na Espanha. Os dados públicos do BOE (endereço, valores, datas, resultado oficial e a URL da ficha) não exigem conta; o scoring, o veredicto, os ônus, a rentabilidade, a avaliação e os relatórios respondem conforme o plano da sua conta, assim como no site.

Endpoints

Canal	URL	Para quê
Servidor MCP (Streamable HTTP)	https://mcp.subastech.com/mcp	Ferramentas para Claude, ChatGPT, Claude Code, Cursor…
Server card MCP	https://mcp.subastech.com/.well-known/mcp/server-card.json	Descrição do servidor e suas ferramentas
Agente A2A (JSON-RPC)	https://mcp.subastech.com/a2a	Agentes que falam Agent-to-Agent
Agent card A2A	https://mcp.subastech.com/.well-known/agent-card.json	Skills, esquemas de segurança e modos
API pública v1 (JSON)	https://app.subastech.com/v1/subastas	Dados do BOE sem autenticação, CORS aberto
OpenAPI 3.1	https://app.subastech.com/openapi.json	Contrato da API v1
Catálogo de APIs (RFC 9727)	https://app.subastech.com/.well-known/api-catalog	Descoberta
Skills para agentes	https://app.subastech.com/.well-known/agent-skills/index.json	Guias passo a passo (SKILL.md)
auth.md	https://app.subastech.com/auth.md	Como autenticar: OAuth 2.1, chaves de API, registro de agentes
Metadados OAuth	https://app.subastech.com/.well-known/oauth-authorization-server	Servidor de autorização
Recurso protegido (PRM)	https://mcp.subastech.com/.well-known/oauth-protected-resource	Metadados do recurso MCP
Guia para modelos	https://app.subastech.com/llms.txt · https://app.subastech.com/llms-full.txt	llms.txt

Qualquer página pública do site também existe em Markdown: peça a mesma URL com o cabeçalho Accept: text/markdown.

Conectar sua IA

Instalação em um clique

• Claude (claude.ai, desktop e mobile): https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Subastech&connectorUrl=https%3A%2F%2Fmcp.subastech.com%2Fmcp — abre o diálogo «Add custom connector» com o nome e a URL já preenchidos; você revisa e confirma (o link não instala nada por conta própria nem concede nenhuma permissão).
• Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=subastech&config=eyJ1cmwiOiJodHRwczovL21jcC5zdWJhc3RlY2guY29tL21jcCJ9
• VS Code: code --add-mcp "{\"name\":\"subastech\",\"type\":\"http\",\"url\":\"https://mcp.subastech.com/mcp\"}"

Claude (claude.ai, desktop e mobile)

1. Com o link acima, ou manualmente: Customize → Connectors (https://claude.ai/customize/connectors) → «+» → Add custom connector.
2. URL do servidor: https://mcp.subastech.com/mcp.
3. No Team e Enterprise, o conector é adicionado primeiro por um proprietário ou administrador em Organization settings → Connectors (https://claude.ai/admin-settings/connectors?modal=add-custom-connector&connectorName=Subastech&connectorUrl=https%3A%2F%2Fmcp.subastech.com%2Fmcp abre esse diálogo já preenchido); depois, cada pessoa clica em «Connect» em Customize → Connectors.
4. Ao usar uma ferramenta que exija conta, o Claude pedirá que você autorize o acesso em https://app.subastech.com/oauth/authorize com sua sessão da Subastech (OAuth 2.1 com PKCE; nunca compartilhe sua senha com o assistente).

Os conectores personalizados funcionam nos planos Free, Pro, Max, Team e Enterprise (no Free, apenas um).

ChatGPT

1. Ative o modo desenvolvedor: Ajustes (Settings) → Security and login → Developer mode. Está disponível em Plus, Pro, Business, Enterprise e Edu na web; dentro de um espaço de trabalho, a política do administrador pode desativá-lo.
2. Vá para https://chatgpt.com/plugins,, clique em «+», dê um nome e uma descrição e, em Connection, indique a URL com o caminho /mcp: https://mcp.subastech.com/mcp.
3. Autorize a conexão quando solicitado (mesmo fluxo OAuth). O ChatGPT usa as ferramentas search e fetch para pesquisa aprofundada e as demais no chat.

A OpenAI não chama mais isso de «conectores»: hoje são plugins (apps MCP) e ficam atrás do modo desenvolvedor. Se você não vê a opção, é porque sua conta ou seu espaço de trabalho não a tem ativada.

Claude Code

claude mcp add --transport http subastech https://mcp.subastech.com/mcp

No primeiro uso, o navegador abre para autorizar (redirecionamento para seu próprio computador, http://localhost/callback).

Cursor e VS Code

• Cursor: o link de um clique acima, ou um servidor MCP do tipo HTTP com a URL https://mcp.subastech.com/mcp.
• VS Code: code --add-mcp "{\"name\":\"subastech\",\"type\":\"http\",\"url\":\"https://mcp.subastech.com/mcp\"}", ou MCP: Add Server pela paleta de comandos.

Outros clientes MCP (Windsurf, MCP Inspector, scripts próprios)

Configure um servidor MCP do tipo HTTP com a URL https://mcp.subastech.com/mcp. Se o cliente não suportar OAuth, crie uma chave de API em https://app.subastech.com/cuenta/integraciones e envie-a como Authorization: Bearer sbk_…. Sem credenciais, as ferramentas públicas funcionam normalmente.

Chaves de API

• São criadas e revogadas em https://app.subastech.com/cuenta/integraciones (até 10 ativas; validade de 30/90/365 dias ou sem validade).
• Cada chave tem suas permissões (scopes); por padrão, somente leitura (*:read). A chave é exibida apenas uma vez.
• Servem no MCP, no agente A2A e na API. Os tokens OAuth são emitidos em https://app.subastech.com/oauth/token.

Ferramentas MCP

Públicas (sem conta)

Ferramenta	O que faz
buscar_subastas	Busca por província, município, tipo, preço, superfície, texto livre, raio ou bbox (até 20 por página)
subasta	Ficha pública por id ou URL: dados do BOE, resumo citável, lotes e resultado oficial
buscar_por_codigo	Localiza por referência BOE, cadastral ou outros identificadores
resultados_recientes	Últimas adjudicações com preço de arrematação do certificado do BOE
estadisticas_publicas	Números do catálogo, províncias, tipos e municípios
explicar_concepto	Glossário de leilões judiciais (sem LLM)
planes	Planos e preços
search / fetch	Contrato de pesquisa aprofundada do ChatGPT

Com conta (conforme plano)

Ferramenta	Permissão	O que faz
analisis_subasta	informes:read	Veredicto e eixos do scoring (Pro ou superior; caso contrário, retorna locked com o plano necessário)
informe	informes:read	Relatório de um leilão com as seções do seu plano; os níveis desbloqueados são entregues, o restante remete ao site
similares, recomendaciones, mercado	informes:read / cuenta:read	Leilões semelhantes, recomendações pessoais e estatísticas de mercado (Pro ou superior)
alertas_listar / previsualizar / crear / editar / eliminar / activar	alertas:read / alertas:write	Alertas de novos leilões por e-mail
favoritos_listar / anadir / quitar	favoritos:read / favoritos:write	Favoritos
mi_cuenta	cuenta:read	Plano, cobranças e permissões do token
notas_simples_listar, nota_simple_estado, nota_simple_pedir	notas:read / notas:write	Nota simples registral (20 €): o pagamento é sempre confirmado no navegador

Quando uma ferramenta está fora do seu plano, ela responde com um cadeado legível por máquina (locked) com a função, o plano mínimo e a URL para ampliar. Nenhuma ferramenta consome cota nem realiza pagamentos por você.

Skills

• buscar-subastas-boe: https://app.subastech.com/.well-known/agent-skills/buscar-subastas-boe/SKILL.md
• interpretar-subasta-judicial: https://app.subastech.com/.well-known/agent-skills/interpretar-subasta-judicial/SKILL.md
• conectar-subastech-mcp: https://app.subastech.com/.well-known/agent-skills/conectar-subastech-mcp/SKILL.md
• crear-alerta-subastech: https://app.subastech.com/.well-known/agent-skills/crear-alerta-subastech/SKILL.md
• comprar-informe-o-nota-simple: https://app.subastech.com/.well-known/agent-skills/comprar-informe-o-nota-simple/SKILL.md

Agente A2A

Endpoint JSON-RPC https://mcp.subastech.com/a2a (versão 1.0; também aceita os nomes de método da 0.3). Skills públicas: buscar-subastas, ficha-subasta, resultados-boe, estadisticas-publicas, explicar-concepto e planes. Com OAuth ou chave de API: analisis-subasta, informe, alertas, favoritos e recomendaciones. Cada resposta inclui os dados do BOE, a URL canônica da ficha e, se aplicável, o cadeado com o plano necessário.

Limites e boas práticas

• Cite sempre a URL canônica da ficha (url) ao exibir um leilão.
• discount é aritmética do BOE (avaliação frente ao valor de leilão), não um veredicto. Não infira scoring, ônus nem rentabilidade: se não vierem, é porque exigem conta.
• Respeite os 429 com Retry-After. Anônimo: 120 requisições/min por IP; com token, conforme plano.
• Parte da análise dos relatórios é gerada com IA: https://app.subastech.com/ia.

Conta gratuita: https://app.subastech.com/registro · Planos: https://app.subastech.com/precios · Este guia: https://app.subastech.com/agentes

---

Página canônica: https://app.subastech.com/agentes · API JSON: https://app.subastech.com/openapi.json · MCP: https://mcp.subastech.com/mcp O scoring, o veredicto, os ônus, a rentabilidade e a avaliação exigem conta: https://app.subastech.com/precios (registro gratuito: https://app.subastech.com/registro) Guia para agentes: https://app.subastech.com/agentes · OpenAPI: https://app.subastech.com/openapi.json · llms.txt: https://app.subastech.com/llms.txt