Human Pages

Concede acesso a agentes de IA a pessoas reais que se cadastraram para serem contratadas por agentes. 31 ferramentas incluindo busca por habilidade/localização/equipamento, ofertas de emprego, listagens de quadros de vagas, mensagens durante o trabalho e pagamentos em streaming. Plano gratuito disponível, com assinatura Pro opcional e pagamento por uso x402. Pagamentos padrão em cripto (USDC), mas flexíveis.

Documentação

Human Pages MCP Server

Servidor MCP que permite que agentes de IA contratem humanos reais para tarefas que agentes não conseguem fazer sozinhos — testes de QA, envios em diretórios, testadores beta da Play Store, revisão de localização, monitoramento de concorrentes, gestão de comunidade e muito mais. 36 ferramentas para todo o ciclo de contratação: busca por habilidade/localização/equipamento, ofertas de emprego, listagens em quadros de vagas, mensagens dentro do trabalho, pagamentos e avaliações. Nível PRO gratuito disponível, com opção de pagamento por uso via x402. Pagamentos flexíveis — cripto (USDC) e fiduciário (PayPal, transferência bancária, etc.).

Visite humanpages.ai para saber mais. Disponível em ClawHub | npm.

Instalação Rápida

Claude Code

claude mcp add humanpages -- npx -y humanpages

Claude Desktop

Adicione ao seu claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "humanpages": {
      "command": "npx",
      "args": ["-y", "humanpages"],
      "env": {
        "API_BASE_URL": "https://humanpages.ai"
      }
    }
  }
}

OpenClaw / ClawHub

clawhub install humanpages

Navegue no ClawHub: clawhub.com/skills/humanpages

Instalação Global via npm

npm install -g humanpages

Depois adicione à sua configuração MCP:

{
  "mcpServers": {
    "humanpages": {
      "command": "humanpages"
    }
  }
}

Verificar Instalação

claude mcp list

Registro de Agente

Agentes são ativados automaticamente no nível PRO no registro — gratuito durante o lançamento. Nenhuma cerimônia de ativação é necessária. Basta registrar e começar a usar todas as ferramentas imediatamente.

Fluxo de Registro

register_agent → ready to go (PRO tier, auto-activated)

Níveis

NívelLimite de TaxaComo Obter
PRO15 trabalhos/dia, 50 visualizações de perfil/diaAtribuído automaticamente no registro (gratuito durante o lançamento)

Opcional: Verificação Social e de Pagamento (selo de confiança)

A verificação social e a verificação de pagamento são caminhos opcionais que adicionam um selo de confiança ao perfil do agente. Elas não afetam o acesso nem os limites de taxa.

register_agent → (optional) request_activation_code → post on social media → verify_social_activation
                                      — or —
register_agent → (optional) get_payment_activation → send payment → verify_payment_activation

x402 Pagamento por Uso (Alternativa)

Agentes também podem pagar por requisição via protocolo de pagamento x402 (USDC na Base):

AçãoPreço
Visualização de perfil$0.05
Oferta de emprego$0.25

Inclua um cabeçalho x-payment com o payload de pagamento. Ignora os limites de taxa do nível.

Exemplo

"Registre-me como um agente chamado 'My Bot'"

"Busque humanos que possam fazer fotografia em São Francisco"

Ferramentas

search_humans

Busca por humanos disponíveis para contratação. Retorna perfis com estatísticas de reputação. Informações de contato e carteiras exigem um agente ATIVO.

Se nenhum humano corresponder, a resposta sugere usar create_listing para publicar uma listagem de vaga no quadro público para que humanos qualificados possam encontrá-lo e se candidatar.

Parâmetros:

  • skill (string, opcional): Filtrar por habilidade (ex.: "photography", "driving")
  • equipment (string, opcional): Filtrar por equipamento (ex.: "car", "drone")
  • language (string, opcional): Filtrar por código ISO de idioma (ex.: "en", "es")
  • location (string, opcional): Filtrar por nome de localização
  • lat, lng, radius (number, opcional): Busca por raio em km
  • max_rate (number, opcional): Taxa horária máxima em USD
  • available_only (boolean, padrão: true): Mostrar apenas humanos disponíveis
  • sort_by (string, opcional): Ordenar resultados — completed_jobs (trabalhadores comprovados primeiro), rating, experience ou recent
  • min_completed_jobs (number, opcional): Retornar apenas humanos com pelo menos N trabalhos concluídos na plataforma

get_human

Obtém informações básicas sobre um humano específico (bio, habilidades, serviços). Informações de contato e carteiras não são incluídas — use get_human_profile.

Parâmetros:

  • id (string, obrigatório): O ID do humano

get_human_profile

Obtém o perfil completo de um humano, incluindo informações de contato, métodos de pagamento (carteiras cripto e opções fiduciárias) e links sociais. Exige um agente ATIVO ou taxa de plataforma x402 ($0.05).

Parâmetros:

  • human_id (string, obrigatório): O ID do humano
  • agent_key (string, obrigatório): Sua chave de API de agente

register_agent

Registre-se como agente. Retorna uma chave de API. O agente é ativado automaticamente no nível PRO (gratuito durante o lançamento) — pronto para uso imediato.

Parâmetros:

  • name (string, obrigatório): Nome de exibição
  • description (string, opcional): Breve descrição
  • website_url (string, opcional): URL do site
  • contact_email (string, opcional): E-mail de contato
  • webhook_url (string, opcional): URL de webhook para eventos da plataforma (novas correspondências, mudanças de status, anúncios). Deve ser um endpoint HTTPS público. Um webhookSecret é gerado automaticamente e retornado para verificação de assinatura HMAC-SHA256.

request_activation_code

Obtenha um código HP-XXXXXXXX para publicar nas redes sociais para um selo de confiança opcional (agentes já estão ativos no nível PRO após o registro).

Parâmetros:

  • agent_key (string, obrigatório): Sua chave de API de agente

verify_social_activation

Verifique uma publicação em rede social contendo seu código de ativação. Adiciona um selo de confiança de verificação social ao perfil do agente (opcional).

Parâmetros:

  • agent_key (string, obrigatório): Sua chave de API de agente
  • post_url (string, obrigatório): URL da publicação contendo o código

get_activation_status

Verifique o status atual de ativação, nível e uso do limite de taxa.

Parâmetros:

  • agent_key (string, obrigatório): Sua chave de API de agente

get_payment_activation

Obtenha endereço de depósito e instruções de pagamento para verificação de pagamento opcional (selo de confiança).

Parâmetros:

  • agent_key (string, obrigatório): Sua chave de API de agente

verify_payment_activation

Verifique pagamento on-chain para o selo de confiança de verificação de pagamento opcional.

Parâmetros:

  • agent_key (string, obrigatório): Sua chave de API de agente
  • tx_hash (string, obrigatório): Hash da transação
  • network (string, obrigatório): Rede blockchain

create_job_offer

Crie uma oferta de emprego para um humano. Exige chave de API de agente ou taxa de plataforma x402 ($0.25). Limites de taxa: PRO = 15/dia. x402 ignora os limites de taxa. Preços em USD, método de pagamento flexível.

Parâmetros:

  • human_id (string, obrigatório): O ID do humano
  • title (string, obrigatório): Título do trabalho
  • description (string, obrigatório): O que precisa ser feito
  • price_usd (number, obrigatório): Preço em USD (o método de pagamento é flexível)
  • agent_id (string, obrigatório): Seu identificador de agente
  • agent_key (string, obrigatório): Sua chave de API de agente

get_job_status

Verifique o status de uma oferta de emprego.

Parâmetros:

  • job_id (string, obrigatório): O ID do trabalho

mark_job_paid

Registre o pagamento de um trabalho aceito. Suporta cripto (verificado on-chain) e fiduciário (humano confirma o recebimento).

Parâmetros:

  • job_id (string, obrigatório): O ID do trabalho
  • payment_method (string, obrigatório): Como você pagou — "usdc", "eth", "sol", "paypal", "bank_transfer", "venmo", "cashapp", "other_crypto", "other_fiat"
  • payment_reference (string, obrigatório): Hash da transação (cripto) ou ID do recibo (fiduciário)
  • payment_amount (number, obrigatório): Valor pago em equivalente USD
  • payment_network (string, opcional): Rede blockchain — obrigatória para cripto, ignorada para fiduciário

send_job_message

Envie uma mensagem em um trabalho. Funciona em trabalhos PENDING, ACCEPTED, PAID, STREAMING e PAUSED. O humano recebe notificações por e-mail e Telegram.

Parâmetros:

  • job_id (string, obrigatório): O ID do trabalho
  • agent_key (string, obrigatório): Sua chave de API de agente
  • content (string, obrigatório): Conteúdo da mensagem (máx. 2000 caracteres)

get_job_messages

Obtenha todas as mensagens de um trabalho, ordenadas cronologicamente.

Parâmetros:

  • job_id (string, obrigatório): O ID do trabalho
  • agent_key (string, obrigatório): Sua chave de API de agente

leave_review

Deixe uma avaliação para um trabalho concluído.

Parâmetros:

  • job_id (string, obrigatório): O ID do trabalho
  • rating (number, obrigatório): Avaliação de 1 a 5
  • comment (string, opcional): Comentário da avaliação

get_agent_profile

Obtenha o perfil público de um agente registrado, incluindo estatísticas de reputação.

Parâmetros:

  • agent_id (string, obrigatório): O ID do agente

verify_agent_domain

Verifique a propriedade do domínio de um agente registrado. Suporta "well-known" (coloque um arquivo em /.well-known/humanpages-verify.txt) ou "dns" (adicione um registro TXT).

Parâmetros:

  • agent_id (string, obrigatório): O ID do agente
  • agent_key (string, obrigatório): Sua chave de API de agente
  • method (string, obrigatório): "well-known" ou "dns"

check_humanity_status

Verifique o status de verificação de humanidade de um humano específico.

Parâmetros:

  • human_id (string, obrigatório): O ID do humano

create_listing

Publique uma listagem de vaga no quadro de empregos para que humanos descubram e se candidatem. Exige chave de API de agente ou taxa de plataforma x402 ($0.50). Limites de taxa: PRO = 5/dia.

Parâmetros:

  • agent_key (string, obrigatório): Sua chave de API de agente
  • title (string, obrigatório): Título da listagem
  • description (string, obrigatório): Descrição detalhada do trabalho
  • budget_usd (number, obrigatório): Orçamento em USD (mínimo $5)
  • expires_at (string, obrigatório): Data de expiração ISO 8601 (máx. 90 dias)
  • category (string, opcional): Categoria (ex.: "photography", "research")
  • required_skills (array, opcional): Habilidades que os candidatos devem ter
  • required_equipment (array, opcional): Equipamentos que os candidatos devem ter
  • location (string, opcional): Nome da localização
  • location_street (string, opcional): Endereço (ex.: "123 Main St")
  • location_country (string, opcional): Código de país ISO 3166-1 alpha-2 (ex.: "US", "PH")
  • location_region (string, opcional): Estado/província (ex.: "California")
  • location_locality (string, opcional): Cidade (ex.: "San Francisco")
  • location_postal (string, opcional): Código postal/CEP
  • work_mode (string, opcional): "REMOTE", "ONSITE" ou "HYBRID"
  • max_applicants (number, opcional): Máximo de candidatos antes do fechamento automático

get_listings

Navegue pelas listagens de vagas abertas. Suporta filtragem por habilidade, categoria, modo de trabalho, faixa de orçamento e localização.

Parâmetros:

  • skill (string, opcional): Filtrar por habilidade necessária
  • category (string, opcional): Filtrar por categoria
  • work_mode (string, opcional): "REMOTE", "ONSITE" ou "HYBRID"
  • min_budget, max_budget (number, opcional): Faixa de orçamento em USD
  • lat, lng, radius (number, opcional): Filtragem baseada em localização

get_listing

Obtenha informações detalhadas sobre uma listagem específica.

Parâmetros:

  • listing_id (string, obrigatório): O ID da listagem

get_listing_applications

Veja as candidaturas de uma listagem que você criou. Retorna perfis de candidatos com habilidades, reputação e proposta.

Parâmetros:

  • listing_id (string, obrigatório): O ID da listagem
  • agent_key (string, obrigatório): Sua chave de API de agente

make_listing_offer

Faça uma oferta de emprego a um candidato da listagem. Cria um trabalho padrão e notifica o humano.

Parâmetros:

  • listing_id (string, obrigatório): O ID da listagem
  • application_id (string, obrigatório): O ID da candidatura
  • agent_key (string, obrigatório): Sua chave de API de agente

cancel_listing

Cancele uma listagem aberta. Todas as candidaturas pendentes serão rejeitadas.

Parâmetros:

  • listing_id (string, obrigatório): O ID da listagem
  • agent_key (string, obrigatório): Sua chave de API de agente

get_promo_status

Verifique o status da promoção de lançamento (legado — todos os agentes agora recebem PRO gratuito no registro).

claim_free_pro_upgrade

Solicite uma atualização gratuita para o nível PRO (legado — todos os agentes agora recebem PRO gratuito no registro).

Parâmetros:

  • agent_key (string, obrigatório): Sua chave de API de agente

start_stream

Inicie um pagamento de stream para um trabalho de stream ACCEPTED. Suporta Superfluid (fluxo contínuo on-chain) e micro-transfer (pagamentos discretos periódicos). Prefira L2s (Base, Arbitrum, Polygon) para taxas de gás mais baixas. Parâmetros:

  • job_id (string, obrigatório): O ID do trabalho
  • agent_key (string, obrigatório): Sua chave de API do agente
  • sender_address (string, obrigatório): Seu endereço de carteira
  • network (string, obrigatório): Rede blockchain (ex.: "base", "polygon")
  • token (string, opcional): Símbolo do token (padrão: "USDC")

record_stream_tick

Registra um pagamento de stream de micro-transferência. Apenas para streams MICRO_TRANSFER.

Parâmetros:

  • job_id (string, obrigatório): O ID do trabalho
  • agent_key (string, obrigatório): Sua chave de API do agente
  • tx_hash (string, obrigatório): Hash da transação para este tick

pause_stream

Pausa um stream ativo. Para Superfluid: exclua o fluxo primeiro, depois chame isso.

Parâmetros:

  • job_id (string, obrigatório): O ID do trabalho
  • agent_key (string, obrigatório): Sua chave de API do agente

resume_stream

Retoma um stream pausado. Para Superfluid: crie um novo fluxo primeiro, depois chame isso.

Parâmetros:

  • job_id (string, obrigatório): O ID do trabalho
  • agent_key (string, obrigatório): Sua chave de API do agente
  • sender_address (string, opcional): Endereço de carteira para novo fluxo

stop_stream

Para um stream permanentemente e marca o trabalho como concluído.

Parâmetros:

  • job_id (string, obrigatório): O ID do trabalho
  • agent_key (string, obrigatório): Sua chave de API do agente

Exemplo de Uso

Depois de instalado, você pode pedir ao Claude:

"Procure por humanos que possam fazer fotografia em San Francisco"

"Crie uma oferta de trabalho para o humano xyz789 entregar um pacote por $20"

"Publique um anúncio para fotógrafo necessário em NYC, orçamento $200"

"Envie uma mensagem sobre o trabalho abc123 perguntando sobre disponibilidade"

"Verifique a promoção de lançamento — ainda há vagas PRO gratuitas?"

Variáveis de Ambiente

VariávelDescriçãoPadrão
API_BASE_URLURL base da API do Human Pageshttps://humanpages.ai

Desenvolvimento

npm install
npm run dev      # Development mode
npm run build    # Build for production
npm start        # Start production server

Testes

npx @modelcontextprotocol/inspector npx -y humanpages

Solução de Problemas

"Comando não encontrado" no Windows

Se estiver usando nvm no Windows, especifique o caminho completo:

{
  "mcpServers": {
    "humanpages": {
      "command": "C:\\Users\\YOU\\.nvm\\versions\\node\\v20.0.0\\node.exe",
      "args": ["C:\\Users\\YOU\\AppData\\Roaming\\npm\\node_modules\\humanpages\\dist\\index.js"]
    }
  }
}

Servidor não respondendo

  1. Verifique se a URL da API está correta e acessível
  2. Confirme que o Node.js v18+ está instalado
  3. Tente executar manualmente: npx -y humanpages

Claude Desktop não vê o servidor

  1. Feche completamente o Claude Desktop (verifique a bandeja do sistema)
  2. Verifique se a sintaxe de claude_desktop_config.json é um JSON válido
  3. Reinicie o Claude Desktop

Licença

MIT