AnchoredIP

MCP para agentes

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

O endpoint

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

Transporte HTTP transmitível. Um único endpoint, POST JSON-RPC, responde application/json. O servidor não mantém estado: não transmite nada e não reté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 suportadas; respondemos na sua onde for possível.

Nenhuma autenticação para conectar. O pedido é o que precisa de uma credencial, e a credencial é emitida pelo pedido.

Adicionando-o 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 bruto

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 aquele arrendamento. Um teste é ativado 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 par 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 par e devolve sua vaga à cota do plano.
renew_lease	access_token, plan?	Fatura outro período e mantém os mesmos endereços. É assim que um teste se torna um cliente pagante.
set_autorenew	access_token, enabled	Impede que uma assinatura de cartão cobre 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á disponível

{"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 execute-o, depois aguarde até um minuto antes do primeiro handshake — um novo par alcança nossa borda na próxima passagem de reconciliação.

O modo de roteamento é a única escolha que um agente pode errar de forma invisível. source é o padrão e funciona somente em Linux: é escrito com regras wg-quick que chamam ip, então em qualquer outro lugar ele não pode rodar ou deleta a interface que acabou de criar, e o usuário fica com um túnel que nunca conecta e nenhuma razão fornecida. 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 arrendado.

Notas para quem está dirigindo

O token de acesso é mostrado uma única vez e não é recuperável pelo protocolo. Dê-o ao usuário às claras 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 esse é o único caminho de volta.

A configuração contém uma chave privada e é retornada apenas 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 PostUp do wg-quick 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 menos um host Linux, peça full.

Relate o preço honestamente. Um plano anual anuncia 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 par para cada trabalhador de curta duração e nunca o revoga esgota a cota do plano e então não consegue subir a próxima máquina. Chame revoke_tunnel quando um trabalhador for aposentado. Revogar o par que segura 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 apenas uma vez, então o endereço só se move para um túnel criado depois dela.

Parar uma assinatura não é um cancelamento. set_autorenew com enabled: false impede a próxima cobrança; o arrendamento vai até o fim do período já pago e a mesma chamada o religa. Apenas uma assinatura por cartão pode ser interrompida — 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 acessível pela internet pública — nosso upstream não carrega o anúncio. Ele funciona entre as máquinas do próprio 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 deva 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 vier: pedir e renovar cinco por hora, túneis e gravações DNS sessenta, ler um arrendamento seiscentas vezes. 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, conforme exige a especificação. Clientes MCP não enviam nenhum e não são afetados.