Skip to main content
Glama
timolein74

asterpay-mcp-server

README.md
# @asterpay/mcp-server

[![Glama](https://glama.ai/mcp/servers/timolein74/asterpay-mcp-server/badge)](https://glama.ai/mcp/servers/timolein74/asterpay-mcp-server)

MCP Server for AsterPay — **KYA (Know Your Agent) trust scoring** and market data for AI agents via Model Context Protocol.

## Features

### KYA Tools (Priority)
- **check_agent_trust** — Full trust score (0–100) for any wallet address (free)
- **verify_agent_identity** — Quick ERC-8004 identity check (free)
- **get_agent_tier** — Tier lookup: Open / Verified / Trusted / Enterprise (free)
- **agent_deep_analysis** — Behavioral intelligence + recommendations ($0.01 via x402)

### Market Data Tools
- **get_market_overview** — Real-time crypto market summary
- **get_crypto_price** — Price data for any cryptocurrency
- **get_fear_greed_index** — Market sentiment index
- **get_trending_coins** — Trending cryptocurrencies
- **get_exchange_rates** — Fiat/crypto exchange rates

### AI & Utilities
- **ai_text_generation** — Generate text with AI
- **ai_sentiment_analysis** — Analyze text sentiment
- **convert_currency** — Currency conversion
- **generate_qr_code** — QR code generation

## Installation

```bash
npx @asterpay/mcp-server
```

Or install globally:

```bash
npm install -g @asterpay/mcp-server
asterpay-mcp-server
```

## Configuration

Add to your MCP client config (e.g., Claude Desktop):

```json
{
  "mcpServers": {
    "asterpay": {
      "command": "npx",
      "args": ["@asterpay/mcp-server"]
    }
  }
}
```

### Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| `ASTERPAY_API_URL` | AsterPay API base URL | `https://x402-api-production-ba87.up.railway.app` |

## API

All KYA tools are free except `agent_deep_analysis` which costs $0.01 USDC via the x402 protocol on Base.

**Base URL:** `https://x402-api-production-ba87.up.railway.app`

## Links

- **Website:** [asterpay.io](https://asterpay.io)
- **KYA Demo:** [asterpay.io/kya](https://asterpay.io/kya/)
- **npm:** [@asterpay/mcp-server](https://www.npmjs.com/package/@asterpay/mcp-server)
- **x402.org:** [Listed](https://x402.org/ecosystem)

## License

MIT

TDQS

A3.7/5.0

Scored across 17 tools

Disambiguation5/5

Each tool has a clearly distinct purpose with no overlap. For example, ai_code_review analyzes code quality, ai_sentiment classifies text sentiment, and get_crypto_price provides price data—all serve unique functions. The descriptions clearly differentiate between AI services, crypto data tools, and utility functions, eliminating any ambiguity.

Naming Consistency4/5

Most tools follow a consistent verb_noun pattern (e.g., check_token_tiers, generate_pdf, get_crypto_price), with clear and descriptive names. However, there are minor deviations like 'ai_' prefix for AI tools and 'whale_alerts' using a noun_verb style, slightly breaking the pattern but remaining readable and intuitive.

Tool Count4/5

With 17 tools, the count is slightly high but reasonable for the broad scope of AsterPay's services, covering AI, crypto, and utilities. It avoids being overwhelming while providing comprehensive functionality. A few tools could potentially be consolidated, but overall, the number aligns well with the server's purpose.

Completeness5/5

The tool set offers complete coverage for AsterPay's domain, including AI-powered services (e.g., review, sentiment, translate), crypto data (e.g., price, OHLCV, trending), and utilities (e.g., PDF generation, QR codes, screenshots). There are no obvious gaps; each tool supports key workflows without dead ends, ensuring agents can handle diverse tasks effectively.