AnchoredIP

MCP para agentes

Um assistente pode comprar um endereço e levantar um túnel sem um humano no circuito. O teste gratuito é o que faz isso funcionar — não há cartão para pedir a ninguém.

O endpoint

https://api.anchoredip.com/api/mcp/

Transporte HTTP streamable. Um endpoint, POST JSON-RPC, responde application/json. O servidor é stateless: ele não transmite nada e não mantém sessão, então você pode enviar initialize e nunca mais mencioná-lo. As versões de protocolo 2025-06-18, 2025-03-26 e 2024-11-05 são faladas; respondemos na sua quando possível.

Sem autenticação para conectar. A compra é o que precisa de uma credencial, e a credencial é emitida pela compra.

Adicionando a um cliente

Claude Code

claude mcp add --transport http anchoredip https://api.anchoredip.com/api/mcp/

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "anchoredip": {
      "type": "http",
      "url": "https://api.anchoredip.com/api/mcp/"
    }
  }
}

Cursor —.cursor/mcp.json

{
  "mcpServers": {
    "anchoredip": { "url": "https://api.anchoredip.com/api/mcp/" }
  }
}

qualquer coisa que fale JSON-RPC puro

curl -s https://api.anchoredip.com/api/mcp/ \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

As ferramentas

Ferramenta	Argumentos	O que faz
list_plans	—	O catálogo com preços ao vivo, durações de prazo e quais métodos de pagamento cada plano aceita.
order_lease	plan, organization_name, country, billing_email	Faz um pedido. Retorna o token de acesso — a única credencial para esse aluguel. Um teste ativa imediatamente.
lease_status	access_token	Endereços mantidos, túneis, expiração, o que é devido.
create_tunnel	access_token, routing_mode?, destinations?, transport?, label?	Provisiona um peer e retorna seu arquivo de configuração, uma vez. Pergunte primeiro para qual máquina é — o modo padrão é somente Linux.
revoke_tunnel	access_token, tunnel_id	Aposenta um peer e devolve sua vaga à cota do plano.
renew_lease	access_token, plan?	Fatura outro período e mantém os mesmos endereços. Como um teste se torna um cliente pagante.
set_autorenew	access_token, enabled	Para a cobrança de uma assinatura de cartão novamente, ou a inicia. Não é um cancelamento — o período já pago se esgota.
set_reverse_dns	access_token, address, hostname	Publica um registro PTR. Um hostname vazio o remove.

Quatro chamadas, do início ao fim

1 — o que está em oferta

{"jsonrpc":"2.0","id":1,"method":"tools/call",
 "params":{"name":"list_plans","arguments":{}}}

2 — peça o teste gratuito

{"jsonrpc":"2.0","id":2,"method":"tools/call",
 "params":{"name":"order_lease","arguments":{
   "plan":"trial",
   "organization_name":"Example GmbH",
   "country":"DE",
   "billing_email":"ops@example.com"}}}

3 — verifique o que obteve

{"jsonrpc":"2.0","id":3,"method":"tools/call",
 "params":{"name":"lease_status","arguments":{"access_token":"…"}}}

4 — obtenha uma configuração funcional

{"jsonrpc":"2.0","id":4,"method":"tools/call",
 "params":{"name":"create_tunnel","arguments":{
   "access_token":"…",
   "routing_mode":"destinations",
   "destinations":["203.0.113.0/24"],
   "label":"agent-provisioned"}}}

A quarta resposta contém todo o .conf. Escreva-o em um arquivo e ative-o, depois aguarde até um minuto antes do primeiro handshake — um novo peer alcança nossa borda na próxima passada de reconciliação.

O modo de roteamento é a única escolha que um agente pode errar invisivelmente. source é o padrão e roda somente em Linux: é escrito com regras wg-quick que chamam ip, então em outros lugares ou não pode rodar ou exclui a interface que acabou de criar, e o usuário fica com um túnel que nunca conecta e sem motivo dado. Pergunte qual é a máquina. Para qualquer coisa que não seja um servidor Linux, passe destinations com os endereços que precisam ver o endereço alugado.

Notas para quem está dirigindo

O token de acesso é mostrado uma vez e não é recuperável pelo protocolo. Entregue-o ao usuário à vista e diga para guardá-lo — não o resuma. Ele pode ser reenviado para o e-mail de cobrança a partir de /leases, e essa é a única rota de volta.

A configuração contém uma chave privada e é retornada uma vez. Escreva-a em um arquivo para o usuário na mesma rodada. Nada a armazena.

Escolha o modo de roteamento deliberadamente. source é o padrão e deixa a rota padrão da máquina intacta, mas é escrito com regras wg-quick PostUp e roda em Linux sob wg-quick e em nenhum outro lugar. Um cliente desktop ou móvel o lê, não encontra rotas para instalar e falha ao conectar sem registrar nada. Para qualquer coisa além de um host Linux, peça full.

Relate o preço honestamente. Um plano anual cita um valor mensal como todo mundo; charged_per_term_usd é o que o cliente realmente paga, e é doze vezes maior.

Devolva as vagas. Um agente que provisiona um peer por worker de curta duração e nunca revoga um esgota a cota do plano e então não consegue levantar a próxima máquina. Chame revoke_tunnel quando um worker for aposentado. Revogar o peer que detém o endereço público interrompe conexões de entrada para ele, e nenhuma máquina sobrevivente pode ser promovida para assumi-lo — uma configuração é emitida uma vez, então o endereço só se move para um túnel criado depois dele.

Parar uma assinatura não é um cancelamento. set_autorenew com enabled: false interrompe a próxima cobrança; o aluguel vai até o fim do período já pago e a mesma chamada o religa. Somente uma assinatura de cartão pode ser parada — uma transferência bancária é um pagamento que o cliente nos envia, então não há nada nosso para cancelar.

IPv6 é delegado, mas ainda não alcançável pela internet pública — nosso upstream não carrega o anúncio. Funciona entre as próprias máquinas do cliente pelo túnel hoje. Diga isso em vez de oferecê-lo como um endereço voltado para a internet; qualquer coisa que a internet precise alcançar precisa do IPv4 em um plano pago.

Limites e segurança

Cada ferramenta é limitada à taxa que o site usa para o mesmo trabalho, porque nos custa o mesmo por qualquer porta que entre: pedidos e renovações cinco por hora, túneis e escritas de DNS sessenta, leitura de um aluguel seiscentos. Ler o catálogo e o handshake do protocolo estão em um orçamento separado e generoso, então um assistente explorando as ferramentas não esgota nada antes de poder comprar.

Cada ferramenta passa pelo mesmo código que o site usa. Não há um caminho de pedido separado aqui que pudesse alocar um endereço que o alocador teria recusado.

Requisições que carregam um cabeçalho de navegador Origin de um site desconhecido são recusadas, como a especificação exige. Clientes MCP não enviam nenhum e não são afetados.