🔓 Give Claude a Wallet — AgentClear MCP Server

Stop manually installing dozens of MCP servers for weather, search, finance, and AI APIs. Install one server, get access to 60+ services through a single API key with sub-cent micropayments. Your Claude can now autonomously discover and pay for any API it needs.

---

Quick Start

1. Get your API key (includes a free $5 grant):

https://agentclear.dev/signup

2. Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "agentclear": {
      "command": "npx",
      "args": ["-y", "agentclear-mcp-server"],
      "env": {
        "AGENTCLEAR_API_KEY": "axk_your_key_here"
      }
    }
  }
}

3. Restart Claude Desktop. That's it — Claude now has a wallet.

---

What This Does

AgentClear turns your Claude into a self-service API consumer. Instead of configuring individual MCP servers for every service, Claude discovers what it needs, calls it, and pays with micropayments from your prepaid balance.

Example Conversation

You: "What's the weather in Tokyo right now?"

Claude: *discovers OpenWeatherMap via AgentClear, calls it, returns results*

  The current weather in Tokyo is 18°C with partly cloudy skies,
  humidity at 62%, and winds from the southeast at 12 km/h.

  [Charged: $0.001 from your AgentClear balance]


You: "Find me recent AI research papers about transformers"

Claude: *discovers arXiv API via AgentClear, searches papers*

  Here are the top recent papers on transformers:
  1. "Efficient Attention Mechanisms for Long-Context Models" — Chen et al., 2026
  2. "Sparse Transformer Architectures at Scale" — Patel & Liu, 2026
  ...

  [Charged: $0.001 from your AgentClear balance]


You: "Translate that abstract into Japanese"

Claude: *discovers DeepL via AgentClear, translates text*

  「長文コンテキストモデルのための効率的なアテンションメカニズム」...

  [Charged: $0.002 from your AgentClear balance]

---

Available Services

AgentClear's marketplace includes 60+ services across these categories:

Category	Examples
Weather & Geo	OpenWeatherMap, Geocoding, Timezone
Search & Web	Brave Search, SerpAPI, Google Trends
AI & ML	Image generation, Embeddings, OCR, Sentiment analysis
Finance	Stock quotes, Crypto prices, Currency exchange
Communication	Email verification, SMS, Push notifications
Data & Research	arXiv, News API, Wikipedia, Web scraping
Translation	DeepL, Google Translate, Language detection
Developer Tools	DNS lookup, IP geolocation, URL shortening
Media	Image search, Screenshot capture, QR code generation

New services are added weekly. Use discover_services to see what's available.

---

How It Works

┌──────────────┐     stdio      ┌─────────────────────┐     HTTPS     ┌──────────────────┐     HTTPS     ┌──────────────┐
│              │ ──────────────▶ │                     │ ─────────────▶│                  │ ─────────────▶│              │
│ Claude       │                │ AgentClear          │               │ AgentClear       │               │ Upstream     │
│ Desktop      │ ◀────────────── │ MCP Server          │ ◀─────────────│ Proxy            │ ◀─────────────│ API          │
│              │    responses   │ (this package)      │   responses   │ (agentclear.dev) │   responses   │ (e.g. OpenAI)│
└──────────────┘               └─────────────────────┘               └──────────────────┘               └──────────────┘
                                        │                                     │
                                        │ reads                               │ deducts
                                        ▼                                     ▼
                                AGENTCLEAR_API_KEY                    Your prepaid balance

1. Claude asks the MCP server to discover or call a service
2. This MCP server forwards the request to the AgentClear proxy with your API key
3. AgentClear authenticates you, routes to the upstream API, meters the call
4. Response flows back through the chain; cost is deducted from your balance

---

MCP Tools

This server exposes three tools to Claude:

discover_services

Search the AgentClear registry by natural language query.

Parameter	Type	Required	Description
query	string	Yes	What you need, e.g. "weather data"
max_results	number	No	1–20, defaults to 5

call_service

Execute an API call through the AgentClear metered proxy.

Parameter	Type	Required	Description
service_id	string	Yes	Service ID from discovery
payload	object	Yes	Request payload for the upstream API

check_balance

Check your current wallet balance. No parameters.

---

Pricing

Signup	Free — includes a $5 grant to start
Per-call pricing	Most APIs cost $0.001–$0.01 per call
No subscriptions	Pay only for what you use
No markup on cheap APIs	Some calls are fractions of a cent

Top up your balance at agentclear.dev/wallet.

---

Configuration

Environment Variables

Variable	Required	Description
AGENTCLEAR_API_KEY	Yes	Your API key from agentclear.dev
AGENTCLEAR_BASE_URL	No	Override the API base URL (default: https://agentclear.dev)

Claude Desktop Config

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

{
  "mcpServers": {
    "agentclear": {
      "command": "npx",
      "args": ["-y", "agentclear-mcp-server"],
      "env": {
        "AGENTCLEAR_API_KEY": "axk_your_key_here"
      }
    }
  }
}

Other MCP Clients

Any MCP-compatible client can use this server. Run it directly:

AGENTCLEAR_API_KEY=axk_your_key npx agentclear-mcp-server

Or install globally:

npm install -g agentclear-mcp-server
AGENTCLEAR_API_KEY=axk_your_key agentclear-mcp-server

---

Development

git clone https://github.com/agentclear/agentclear-mcp-server.git
cd agentclear-mcp-server
npm install
npm run build

Test locally:

AGENTCLEAR_API_KEY=axk_test npm start

---

Error Handling

The server handles common error cases gracefully:

HTTP Status	Meaning	Server Response
401	Invalid API key	Prompts to check or regenerate key
402	Insufficient balance	Prompts to add funds
404	Service not found	Suggests using discover_services first
429	Rate limited	Asks to wait and retry

---

Contributing

Contributions welcome! Please open an issue or pull request on GitHub.

License

MIT — see LICENSE.

---

Built by AgentClear — the API marketplace for AI agents.