↑↓ navigate open esc close
MCP sobre HTTP · 26 ferramentas

Dados de contratação pública que o seu agente pode usar sozinho.

Point any MCP-capable client — Claude Desktop, Claude Code, Cursor, or your own agent — at our streamable-HTTP endpoint. It can search Singapore government contracts, drill into buyers and suppliers, keep lists, and even self-register and pay for access with no human in the loop.

# Endpoint

https://staging-app.selltostate.com/api/mcp

# Listar as ferramentas (aberto, sem autenticação)

curl -s https://staging-app.selltostate.com/api/mcp \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,
       "method":"tools/list"}'

tools/list is open; tools/call resolves your credential and 402s if un-entitled.

O fluxo de conexão.

  1. 1

    Descobrir

    Clientes compatíveis com a especificação leem /.well-known/oauth-protected-resource (RFC 9728) e /.well-known/oauth-authorization-server (RFC 8414) para conhecer o recurso, o emissor e os escopos.

  2. 2

    Registrar

    Sem credencial pré-partilhada, o cliente autocadastra-se via RFC 7591 DCR (POST /api/oidc/register) e recebe um client_id com zero escopos de dados mais um payment_link.

  3. 3

    Autenticar

    Apresente o cliente emitido como Authorization: Bearer client:<client_id> em cada tools/call. (O fluxo completo de código OAuth 2.1 está no roteiro; o Bearer shim já funciona hoje.)

  4. 4

    Assinar

    Até que o sujeito do cliente tenha direito de acesso, cada tools/call devolve o mesmo corpo 402 que o REST — um payment_link para humanos e o recurso machine_payment nativo para agentes. O agente chama pay, é cobrado fora de sessão (off-session), e a chamada seguinte devolve os dados.

26 ferramentas, com paridade ao REST.

Every tool mirrors a REST endpoint 1:1. Owner-scoped list / saved-search tools require a user API key; an OIDC client token gets a requires_user_key result. Full schemas in the reference.

whoami data:read Identidade + direito de acesso + escopos (sem restrição — verifique antes de gastar).
search data:read Pesquisa facetada num único escopo: tenders | buyers | suppliers | sectors.
search_awards data:read Explorador de adjudicações (q, órgão, fornecedor, categoria, ano, intervalo de valor).
get_buyer data:read Detalhe do órgão contratante (get_buyer_detail é um alias mantido).
get_supplier_detail data:read Detalhe do fornecedor com principais compradores + distribuição por setor.
get_sector / get_tender data:read Perfil de setor · uma adjudicação individual + adjudicações relacionadas.
list_buyers / list_suppliers / list_sectors data:read Top N de órgãos, fornecedores e a taxonomia de setores.
get_lists / create_list / add_to_list … data:read CRUD de listas de adjudicações guardadas — requer uma chave de API de usuário.
get_saved_searches / save_search … data:read CRUD de pesquisas guardadas — requer uma chave de API de usuário.
export data:export Exportar um conjunto filtrado de adjudicações como CSV.
pay billing:pay Pague autonomamente com um token Stripe para desbloquear o acesso — sem página de checkout.

Chame uma ferramenta.

curl -s https://staging-app.selltostate.com/api/mcp \
  -H "Authorization: Bearer client:c_abc123" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"search",
                 "arguments":{"scope":"tenders","q":"cloud","year_min":2024}}}'

Depois de conectado, basta perguntar

  • → "Pesquise no Sell to State adjudicações de cibersegurança em 2024 e resuma os 5 principais fornecedores."
  • → "Extraia todas as adjudicações que o Ministério da Educação fez este ano e exporte-as como CSV."
  • → "Use get_buyer no órgão relevante — de quem Singapura compra serviços de construção?"

Conecte o seu agente.

Create an account, generate an API key, and point your MCP client at https://staging-app.selltostate.com/api/mcp. Agents can also self-register and pay without a dashboard. Full tool docs at docs.selltostate.com.

Start for free →
Registe-se