{
  "markdown": "# 👽 Alien Plugg x402 API SDK\n\n[![x402 Enabled](https://img.shields.io/badge/x402-Enabled-blue.svg)](https://x402.org)\n[![Base Network](https://img.shields.io/badge/Network-Base%20(EIP--155%3A8453)-blue)](https://base.org)\n[![USDC Payment](https://img.shields.io/badge/Payment-USDC-green)](https://circle.com/usdc)\n[![MCP Protocol](https://img.shields.io/badge/MCP-2024--11--05-purple)](https://modelcontextprotocol.io)\n\n> *\"What I have is outta this world 👽🌌\"*\n\nWelcome to the **Alien Plugg x402 API SDK**. Alien Plugg operates **30 pay-per-call x402 API endpoints** and a Model Context Protocol (MCP) server on the **Base network** (Chain ID `8453`). Built specifically for AI agents, trading bots, and Web3 developers, every endpoint is monetized natively using the open [x402 protocol](https://x402.org) with USDC payments.\n\n---\n\n## ⚡ Quick Start (Time to First \"Hello World\" < 60s)\n\nNo API keys or registration required. You only pay micro-fractions of USDC per request via your EVM wallet.\n\n### 1. Free Endpoint Discovery (0 Seconds Setup)\n\nFetch the live catalog of all available endpoints in less than 5 seconds:\n\n```bash\ncurl -s https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/discovery\n```\n\n### 2. Make Your First Paid Request (< 60 Seconds)\n\nTo make pay-per-call requests, use any x402-compatible SDK (`coinbase` for Python or `@coinbase/x402` for Node.js):\n\n#### Python Quickstart\n```python\nfrom coinbase import x402\nimport os\n\n# Initialize client with your Base wallet private key\nclient = x402.Client(\n    private_key=os.getenv(\"EVM_PRIVATE_KEY\"),\n    chain_id=8453 # Base\n)\n\n# Call gas-tracker ($0.002) - x402 automatically handles the HTTP 402 handshake & payment\nresponse = client.get(\"https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/gas-tracker\")\nprint(response.json())\n```\n\n---\n\n## 📋 Full API Endpoint Catalog (30 Endpoints)\n\nBase URL: `https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/`\n\n### 1. Crypto & Trading\n| Endpoint | Price (USDC) | Description |\n| :--- | :--- | :--- |\n| `zora-scanner` | `$0.010` | Trending Zora coins + BUY / SELL / STRONG_BUY trading signals |\n| `robinhood-scanner` | `$0.010` | Robinhood Chain trending tokens + momentum signals |\n| `zora-rug-check` | `$0.020` | Rug risk scoring (0-100) + LOW/MEDIUM/HIGH/CRITICAL verdict |\n| `zora-portfolio` | `$0.005` | Wallet token holdings, PnL tracking, and asset allocation |\n| `zora-sentiment` | `$0.050` | Social sentiment scoring + ACCUMULATE/HOLD/REDUCE recommendations |\n| `token-price` | `$0.015` | Real-time token pricing lookup by ID, symbol, or contract address |\n| `token-compare` | `$0.005` | Side-by-side token comparison + automated winner verdict |\n| `chart-roast` | `$0.008` | Brutal technical chart analysis + market breakdown |\n| `alien-plugg-alpha` | `$0.050` | Daily curated trading signals — top alpha picks, rug warnings, DCA strategies |\n| `honeypot-check` | `$0.040` | On-chain honeypot detection — tests buy/sell tax & execute rights |\n| `price-alerts` | `$0.008` | Token price alert trigger management & state tracking |\n\n### 2. On-Chain Analysis & Forensics\n| Endpoint | Price (USDC) | Description |\n| :--- | :--- | :--- |\n| `whale-tracker` | `$0.080` | Real-time whale transfer detection on Base network |\n| `wallet-profile` | `$0.003` | On-chain wallet profiler + behavioral labels & historical activity |\n| `smart-money` | `$0.080` | Track smart money wallets, accumulation patterns, and DEX flow |\n| `dex-flow` | `$0.120` | Uniswap V3 liquidity flow & volume depth analysis |\n| `new-launches` | `$0.010` | Fresh token launch scanner on Zora & Base |\n| `creator-lookup` | `$0.010` | Token creator profile analysis + portfolio of launched coins |\n| `gas-tracker` | `$0.002` | Real-time Base network gas prices & fee estimates |\n| `tx-status` | `$0.002` | Transaction execution status & receipt parser |\n| `holder-analysis` | `$0.030` | Token holder concentration, distribution, and Gini coefficient |\n\n### 3. Web & Utility Tools\n| Endpoint | Price (USDC) | Description |\n| :--- | :--- | :--- |\n| `translate` | `$0.005` | Multi-language translation API supporting 100+ languages |\n| `ip-info` | `$0.0015` | IP geolocation, ISP detection, and VPN/proxy flags |\n| `expand-url` | `$0.015` | URL shortener expansion & HTTP redirect chain tracer |\n| `tech-stack-detect` | `$0.008` | Website technology stack fingerprinting |\n| `webpage-diff` | `$0.030` | Webpage content change monitoring + visual diff |\n| `builder-score` | `$0.008` | AI-powered developer & builder reputation score |\n\n### 4. Discovery & Protocol Handshake\n| Endpoint | Price (USDC) | Description |\n| :--- | :--- | :--- |\n| `discovery` | **`FREE`** | Full catalog of endpoints, prices, descriptions, and token metadata |\n| `.well-known/x402.json` | **`FREE`** | Standard x402 service discovery manifest |\n| `mcp-server` / `mcpHandshake` | `$0.005` | Model Context Protocol (MCP) server providing 10 curated tools for AI agents |\n| `health` | **`FREE`** | Gateway health check and service latency metric |\n\n---\n\n## 💻 Code Examples\n\nComplete script examples are located in the [`examples/`](./examples/) folder.\n\n### cURL (`examples/curl.sh`)\n\n```bash\n# 1. Discover endpoints (FREE)\ncurl -s https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/discovery\n\n# 2. Call gas-tracker ($0.002) with x402 payment header\ncurl -s -H \"X-PAYMENT: <x402-payment-signature>\" \\\n  https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/gas-tracker\n\n# 3. Call daily trading signals ($0.05)\ncurl -s -H \"X-PAYMENT: <x402-payment-signature>\" \\\n  https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/alien-plugg-alpha\n```\n\n### Python (`examples/python.py`)\n\n```python\nimport os\nimport json\nfrom coinbase import x402\n\n# Initialize Coinbase x402 client\nx402_client = x402.Client(\n    private_key=os.getenv(\"EVM_PRIVATE_KEY\"),\n    chain_id=8453\n)\n\n# 1. Free endpoint discovery\ndiscovery_data = x402_client.get(\"https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/discovery\").json()\n\n# 2. Call gas-tracker ($0.002)\ngas_data = x402_client.get(\"https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/gas-tracker\").json()\n\n# 3. Fetch Alien Plugg Alpha Daily Report ($0.05)\nalpha_report = x402_client.get(\"https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/alien-plugg-alpha\").json()\n```\n\n### Node.js (`examples/nodejs.js`)\n\n```javascript\nimport { x402Client } from \"@coinbase/x402\";\n\nconst client = new x402Client({\n  privateKey: process.env.EVM_PRIVATE_KEY,\n  chainId: 8453\n});\n\n// 1. Discover endpoints\nconst discovery = await fetch(\"https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/discovery\").then(r => r.json());\n\n// 2. Call paid gas-tracker endpoint ($0.002)\nconst gasResponse = await client.fetch(\"https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/gas-tracker\");\nconst gasData = await gasResponse.json();\n\n// 3. Fetch Alien Plugg Alpha signals ($0.05)\nconst alphaResponse = await client.fetch(\"https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/alien-plugg-alpha\");\nconst alphaData = await alphaResponse.json();\n```\n\n---\n\n## 🤖 MCP Server Setup for AI Agents\n\nAlien Plugg provides a Model Context Protocol (MCP) server exposing 10 interactive tools for LLM platforms like Claude Desktop, Cursor, and custom agentic frameworks.\n\n**MCP Server Endpoint URL:**\n`https://base44.app/api/apps/6a5fdd57651262e86b24133e/functions/mcpHandshake`\n\n### 1. Claude Desktop Setup\n\nAdd the following to your `claude_desktop_config.json` file:\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"alien-plugg\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@modelcontextprotocol/server-fetch\",\n        \"https://base44.app/api/apps/6a5fdd57651262e86b24133e/functions/mcpHandshake\"\n      ]\n    }\n  }\n}\n```\n\n### 2. Cursor IDE Setup\n\nAdd the configuration in Cursor **Settings -> Features -> MCP** or in `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"alien-plugg\": {\n      \"url\": \"https://base44.app/api/apps/6a5fdd57651262e86b24133e/functions/mcpHandshake\",\n      \"transport\": \"http\"\n    }\n  }\n}\n```\n\n---\n\n## 🔗 Official Links & Resources\n\n- 🛰️ **API Base URL:** [`https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/`](https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/)\n- 🔍 **Discovery Endpoint:** [`https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/discovery`](https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/discovery)\n- 🌐 **Landing Page:** [Alien Plugg Web Portal](https://base44.app/api/apps/6a5fdd57651262e86b24133e/files/mp/public/6a5fdd57651262e86b24133e/1a205d56c_landing-page.html)\n- 📄 **llms.txt Specification:** [Alien Plugg llms.txt](https://base44.app/api/apps/6a5fdd57651262e86b24133e/files/mp/public/6a5fdd57651262e86b24133e/defdb7edc_llms.txt)\n- 🤖 **MCP Handshake URL:** [`https://base44.app/api/apps/6a5fdd57651262e86b24133e/functions/mcpHandshake`](https://base44.app/api/apps/6a5fdd57651262e86b24133e/functions/mcpHandshake)\n\n### 🪙 Token Contracts\n\n- **PLUGG on Base Network:** [`0xDe76415CeBe959CF0738e8A636d9153fF295bba3`](https://bankr.bot/launches/0xDe76415CeBe959CF0738e8A636d9153fF295bba3)\n- **PLUGG on Robinhood Chain:** [`0x09d56eaCb69E85Dca856B6dc15fA6aE9eeaBFBa3`](https://bankr.bot/launches/0x09d56eaCb69E85Dca856B6dc15fA6aE9eeaBFBa3)\n\n---\n\n## 📄 License\n\nMIT License. Built for the open AI agent ecosystem.\n",
  "bytes": 9573,
  "sha": "706204dde70fcf3de4f634f10cfdcb38f386b2e6394dd23e111a1ed42453de4f",
  "repo_slug": "michaelhutchings626-hub/alien-plugg-x402",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_michaelhutchings626_hub_alien__2f720a7b/readme"
}