Skip to main content
Glama
README.md
# šŸš€ Alpha402 — DexScreener, GoPlus Honeypot Security & Polymarket Alpha MCP

[![Glama MCP Server](https://glama.ai/mcp/servers/monsterbyurbed11/alpha402/badge)](https://glama.ai/mcp/servers/monsterbyurbed11/alpha402)
[![npm version](https://img.shields.io/npm/v/alpha402-mcp.svg)](https://www.npmjs.com/package/alpha402-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![M8ven Score](https://m8ven.ai/badge/mcp/monsterbyurbed11-alpha402-16f2fi?v=0dd7b7032645e2e041c7f79d7223fbc2)](https://m8ven.ai/mcp/monsterbyurbed11-alpha402-16f2fi?s=readme)

Real-time **DexScreener** liquidity & momentum metrics, **GoPlus** fail-closed anti-honeypot smart contract security audits, newly active safe pool discovery (`/v1/new-pairs` + SSE stream), and **Polymarket** prediction market arbitrage opportunities for autonomous **AI Agents** across **Base, Solana, Ethereum, BSC, Arbitrum, and Polygon**.

* šŸŽ **Zero-Config Free Tier (3 Free Calls / Day)**: Start immediately in Claude Desktop, Cursor, Glama, or Smithery with **no wallet setup required** for your first 3 queries every day.
* ⚔ **Instant Prepaid Base USDC Credits (`$1.00 = 200 Security Audits / 50 Alpha Calls`)**: Send `$1.00 USDC` once on Base to `0x8a8c238ed2b46908Ff6C6922a3870984f20f8913` and pass your transaction hash (`0x...`) for sub-20ms credit deduction and zero RPC wait time on subsequent calls.
* šŸŖ™ **Official Coinbase `x402` Standard (`x402Version: 1`) & Lightning `L402`**: Compatible out-of-the-box with `x402-fetch`, `x402-axios`, and Coinbase CDP AgentKit.

🌐 **Live Production Gateway**: `https://alpha402.acter.workers.dev`  
šŸ“Š **Live Funnel & Revenue Analytics**: `https://alpha402.acter.workers.dev/v1/analytics`

---

## šŸ“¦ Quick Start: MCP Server (Claude Desktop, Cursor, Cline, Windsurf, Glama)

### Option A: Local Zero-Config (Recommended)
Add to your `claude_desktop_config.json` or `cursor.json`. First **3 calls/day are 100% free with zero setup or wallet required**:

```json
{
  "mcpServers": {
    "alpha402": {
      "command": "npx",
      "args": ["-y", "alpha402-mcp"]
    }
  }
}
```

### Option B: Remote SSE (Zero Node.js / NPM Install Required)
Connect directly to our hosted Cloudflare Worker MCP SSE endpoint:

```json
{
  "mcpServers": {
    "alpha402": {
      "url": "https://alpha402.acter.workers.dev/sse"
    }
  }
}
```

### Option C: High-Frequency Trading Bots (Optional Prepaid Credits)
If running automated trading bots (like ElizaOS) needing unlimited sub-20ms queries:

```json
{
  "mcpServers": {
    "alpha402": {
      "command": "npx",
      "args": ["-y", "alpha402-mcp"],
      "env": {
        "ALPHA402_TX_HASH": "0x_YOUR_PREPAID_BASE_USDC_TX_HASH"
      }
    }
  }
}
```

### Available MCP Tools & REST Endpoints
| Tool / Endpoint | Free Tier | Unlimited Price | Description |
| :--- | :--- | :--- | :--- |
| `check_token_security` / `GET /v1/token-security` | **3 Free / Day** | **$0.005 USDC** (5 sats) | Fast fail-closed GoPlus contract audit (honeypot, buy/sell tax, balance mod, freeze authority). |
| `get_token_alpha` / `GET /v1/token-alpha` | **3 Free / Day** | **$0.02 USDC** (20 sats) | Full composite AlphaScore (Security 40% + Momentum 35% + Liquidity 25%) + wash-trading filter. |
| `get_new_pairs_alpha` / `GET /v1/new-pairs` | **3 Free / Day** | **$0.02 USDC** (20 sats) | Scans newly active & boosted pools on Base/Solana/ETH/BSC/Arb/Polygon, filters out honeypots, and ranks safe pools by AlphaScore. |
| `GET /v1/new-pairs/stream` | **3 Free / Day** | **$0.02 USDC** (20 sats) | Real-time Server-Sent Events (`text/event-stream`) feed of verified safe new pairs. |
| `get_polymarket_alpha` / `GET /v1/polymarket-alpha` | **3 Free / Day** | **$0.01 USDC** (10 sats) | Top volume prediction markets, outcome prices, and binary arbitrage spreads. |
| `get_credits_and_payment_info` / `GET /v1/credits` | **Always Free** | **$0.00 (Free)** | Check remaining prepaid USDC credit balance for any `0x...` txHash or get deposit instructions. |

---

## ⚔ Instant Multi-Call Prepaid Credits (Built for High-Speed Trading Bots)
Per-request on-chain transfers are too slow for sniper bots. Alpha402 solves this automatically:
1. Send any amount $\ge \$0.005$ USDC on Base to `0x8a8c238ed2b46908Ff6C6922a3870984f20f8913` (e.g., **$1.00 USDC** = `1,000,000` units).
2. Pass `paymentProof: "0x<your_tx_hash>"` in any MCP tool call or `Authorization: x402 0x<your_tx_hash>` on REST requests.
3. **Call #1** verifies the receipt on Base RPC and initializes your credit balance (`$0.98` remaining = 49 more alpha calls or 196 security calls).
4. **Subsequent Calls** skip Base RPC completely and deduct credits in **< 20ms**, returning `X-402-Credits-Remaining-USDC` and `X-402-Calls-Remaining` headers on every response!

---

## šŸ›”ļø Critical Fail-Closed & Automatic Credit Refund Policy
For pre-swap checks, **failing open is a catastrophic bug**. If the upstream security auditor (GoPlus) times out (4s timeout), errors, or cannot verify a contract:
* `auditStatus` is set to `UNAVAILABLE` / `TIMEOUT`.
* HTTP `503 Service Unavailable` is returned and market data is withheld (`data: null`).
* **Atomic Credit Refund:** The worker automatically refunds your exact call cost (`reusableCredit: true, charged: false`).

TDQS

A3.9/5.0

Scored across 5 tools

Disambiguation4/5

Each tool targets a distinct surface: Polymarket markets, token security, token AlphaScore, new-pair discovery, and credit checks. However, get_token_alpha partially overlaps with check_token_security because security is a 40% component of the score, and get_new_pairs_alpha also invokes security filtering and AlphaScore ranking, so boundaries are clear but not perfectly crisp.

Naming Consistency5/5

All tools use snake_case with a predictable verb_noun structure, mostly get_* plus check_token_security. The one check_* verb is appropriate and does not break the pattern.

Tool Count5/5

Five tools is well-scoped for a focused crypto alpha/security server. Each tool covers a meaningful capability without redundancy or filler.

Completeness4/5

The surface covers the core domain well: market alpha, contract safety, token scoring, new-pair discovery, and billing/credit lookup. Minor gaps exist, such as no direct general token price/history lookup, but agents can work around this through the existing AlphaScore and new-pairs tools.

Maintenance

ActivityMaintained
ResponsivenessOutdated data