@valeo-ace/mcp

MCP server that lets AI agents borrow USDC through Agent Credit Engine.

Setup

Works with any MCP-compatible client: Claude Code, Cursor, Windsurf, Cline, LangChain, CrewAI, etc.

Claude Code / Cursor

Add to your MCP config (.cursor/mcp.json or Claude's mcp_servers.json):

{
  "mcpServers": {
    "ace": {
      "command": "npx",
      "args": ["@valeo-ace/mcp"]
    }
  }
}

Restart your client. The ACE tools will appear automatically.

Manual / npx

npx @valeo-ace/mcp

Tools

| Tool | Description | |------|-------------| | ace_register | Register for an ACE API key. Call this first. | | ace_create_agent | Create an AI agent identity on ACE. | | ace_connect_wallet | Connect a Solana wallet to your agent. | | ace_request_credit | Request USDC credit. Funds sent to your wallet on Solana. | | ace_check_loan | Check loan status and disbursement. | | ace_check_balance | Check risk score, credit profile, and available credit. | | ace_get_credit_line | Get credit line limits and usage. |

Example Conversation

User: I need my agent to borrow 5 USDC to pay for a DataProvider API call.

Agent: I'll set up ACE credit for you.

[calls ace_register with email and name]
→ "Registered successfully. API key saved."

[calls ace_create_agent with name "Trading Bot Alpha"]
→ "Agent created: Trading Bot Alpha (ID: cmm...)."

[calls ace_connect_wallet with your Solana address]
→ "Wallet connected. ACE will send USDC here."

[calls ace_request_credit with amount "5.00" and purpose "DataProvider API call"]
→ "APPROVED: 5.00 USDC credit. Loan ID: cmm... Fee: 0.15 USDC (3%).
   Total due: 5.15 USDC within 24 hours.
   USDC is being sent to your wallet now."

Done! When revenue arrives in your wallet, ACE auto-repays the loan.

Environment Variables

The server works with zero configuration. State is persisted in ~/.ace/config.json.

For advanced use, these env vars skip the corresponding setup tools:

| Variable | Description | |----------|-------------| | ACE_API_KEY | Use this API key instead of registering | | ACE_BASE_URL | Override API URL (default: https://api.agentcreditengine.com) | | ACE_AGENT_ID | Use this agent ID instead of creating one |

Example with env vars:

{
  "mcpServers": {
    "ace": {
      "command": "npx",
      "args": ["@valeo-ace/mcp"],
      "env": {
        "ACE_API_KEY": "vak_your_key_here",
        "ACE_AGENT_ID": "cmm_your_agent_id"
      }
    }
  }
}

How It Works

1. Register — creates an ACE account and stores the API key locally
2. Create Agent — registers your AI agent identity with ACE
3. Connect Wallet — links a Solana wallet for USDC disbursement and revenue monitoring
4. Request Credit — borrows USDC, which is sent on-chain to your wallet
5. Auto-Repay — when revenue arrives, ACE detects it and repays the loan automatically

Full Documentation

https://docs.agentcreditengine.com

License

MIT