AssetFare

npx add-mcp 'https://api.assetfare.dev/mcp'

AssetFare MCP — API de ponte de Solana para Base ou Arbitrum

Um wrapper de cliente/servidor MCP para os fluxos de trabalho limitados e não custodiais da AssetFare de Solana SOL → ETH na Base ou ETH na Arbitrum. Use-o quando um agente de IA precisar de uma cotação verificável, fluxo de ponte ou plano de execução não assinado, sem entregar a custódia a um serviço de roteamento.

O MCP é opcional. A interface de máquina principal da AssetFare é a API REST pública descrita pelo OpenAPI. Os agentes podem obter e comparar uma cotação sem instalar este wrapper:

• APIs.json: https://assetfare.dev/apis.json
• OpenAPI: https://api.assetfare.dev/openapi.json
• Fluxo de trabalho Arazzo somente leitura: https://assetfare.dev/arazzo.yaml

Modelo de segurança

• O MCP da AssetFare nunca aceita uma chave privada e nunca assina ou envia uma transação.
• As ferramentas somente leitura expõem o status atual, o manifesto assinado e as cotações.
• As ferramentas que alteram o estado apenas criam registros de autenticação/sessão ou preparam/verificam ações de fluxo de trabalho não assinadas. Os clientes MCP devem exigir aprovação do usuário para essas chamadas.
• O chamador verifica de forma independente cada ação não assinada retornada e assina/envia com suas próprias carteiras.

Endpoint remoto

https://api.assetfare.dev/mcp

Servidor oficial do Registro MCP: io.github.odaiin/assetfare.

Primeira chamada REST/OpenAPI

Use o endpoint público de cotações quando um agente não tiver conectado explicitamente o MCP. Nenhuma chave de API, autenticação de carteira, sessão, assinatura ou transação é necessária para esta chamada de avaliação somente leitura:

node examples/rest-quote.mjs 300
python3 examples/rest_quote.py 300

curl -sS https://api.assetfare.dev/v1/quote \
  -H 'content-type: application/json' \
  -d '{"from_chain":"solana","from_token":"SOL","to_chain":"base","to_token":"ETH","amount_usd":300}'

Conecte um cliente MCP remoto diretamente — nenhuma instalação de pacote ou chave de API da AssetFare é necessária:

claude mcp add --transport http assetfare https://api.assetfare.dev/mcp

{
  "mcpServers": {
    "assetfare": {
      "url": "https://api.assetfare.dev/mcp"
    }
  }
}

Codex CLI e aplicativo

Adicione o servidor remoto pela CLI:

codex mcp add assetfare --url https://api.assetfare.dev/mcp

Ou adicione-o a ~/.codex/config.toml ou a um projeto .codex/config.toml. O modo de aprovação writes solicita ferramentas que não são anotadas como somente leitura:

[mcp_servers.assetfare]
url = "https://api.assetfare.dev/mcp"
default_tools_approval_mode = "writes"

Gemini CLI

gemini mcp add --transport http assetfare https://api.assetfare.dev/mcp

Entrada ~/.gemini/settings.json equivalente:

{
  "mcpServers": {
    "assetfare": {
      "url": "https://api.assetfare.dev/mcp",
      "type": "http",
      "trust": false
    }
  }
}

Cursor

Adicione o seguinte servidor a um projeto .cursor/mcp.json ou ao ~/.cursor/mcp.json global:

{
  "mcpServers": {
    "assetfare": {
      "url": "https://api.assetfare.dev/mcp"
    }
  }
}

A conexão não é autenticada. As ferramentas de execução posteriormente exigem o token vinculado à carteira produzido pelo fluxo signMessage não transacional da AssetFare. Não coloque esse token em nenhum arquivo de configuração do MCP.

Habilidade do agente

A Habilidade de Agente portátil é skills/assetfare-route/SKILL.md. Clientes compatíveis com Skills.lc podem instalá-la diretamente deste repositório público do GitHub.

Avaliação da primeira chamada

Execute npm run first-call-eval para verificar se um novo cliente MCP consegue descobrir as ferramentas, validar o manifesto assinado e o status, e obter uma cotação de $300 sem criar um login de carteira, sessão, assinatura ou transação.

Use Streamable HTTP. O endpoint não tem chave de API no lado do servidor; a autenticação da carteira acontece por meio das ferramentas da AssetFare.

stdio local

O repositório também contém um wrapper compatível com stdio para auto-hospedagem. A entrada pública do Registro usa o endpoint remoto Streamable HTTP; a publicação no npm é intencionalmente adiada até uma revisão separada de lançamento de pacote.

Material de confiança

• Contato de segurança: security@assetfare.dev
• Política de segurança e relato privado: https://github.com/odaiin/assetfare-mcp/security/policy
• Manifesto assinado: https://api.assetfare.dev/.well-known/assetfare-manifest.json
• Chave pública de assinatura: https://assetfare.dev/.well-known/assetfare-manifest.pub
• Status: https://api.assetfare.dev/v1/status
• OpenAPI: https://api.assetfare.dev/openapi.json
• APIs.json: https://assetfare.dev/apis.json
• Arazzo: https://assetfare.dev/arazzo.yaml
• Cartão do servidor: https://api.assetfare.dev/.well-known/mcp/server-card.json
• Guia do agente: https://assetfare.dev/llms-full.txt
• Evidência da mainnet: https://assetfare.dev/evidence/
• Comparação ao vivo com a mesma entrada: https://assetfare.dev/compare/solana-to-base/

Descoberta

• Registro MCP oficial: io.github.odaiin/assetfare
• Smithery: https://smithery.ai/servers/twotw55/assetfare
• Glama: https://glama.ai/mcp/connectors/io.github.odaiin/assetfare
• Habilidade de Agente: https://www.skills.sh/odaiin/assetfare-mcp/assetfare-route

O wrapper contém deliberadamente nenhum mecanismo de rota da AssetFare, carteiras, credenciais RPC ou dados de operações internas.

Caso de uso do agente

Para uma solicitação de $300 de Solana para Base ou Solana para Arbitrum, um agente lê o manifesto assinado e o status, chama assetfare_quote com destination_chain, compara o recebimento executável divulgado e o ETA, e só então pede ao proprietário da carteira que aprove a mensagem de login não transacional. O agente assina e envia de forma independente cada ação on-chain; este servidor MCP nunca faz isso.

Consulte o script de avaliação da primeira chamada, a evidência pública da mainnet em https://assetfare.dev/evidence/, e o estudo de caso de ponta a ponta em https://assetfare.dev/case-studies/solana-to-base-mainnet-canary/.