{
  "markdown": "# Alpha MCP\n\n> **Korean crypto narratives + AI synthesis as MCP tools.** Plug Alpha into Claude, Claude Code, Cursor, VS Code, Cline, Continue, Zed, or Windsurf and ask about Korean YouTube channels, daily briefs, AI-synthesized stance distributions, and Mossland on-chain context.\n\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-land.moss%2Falpha--mcp-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=land.moss/alpha-mcp)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Alpha](https://img.shields.io/badge/Live-alpha.moss.land-purple)](https://alpha.moss.land/)\n\nAlpha MCP is the official Model Context Protocol server for [Alpha by Mossland](https://alpha.moss.land?utm_source=github&utm_medium=referral&utm_campaign=alpha-mcp-readme), a Korean-first crypto × AI media platform. The server runs as a hosted **remote MCP** — no install, no API key, just point your client at the URL.\n\n```\nhttps://alpha.moss.land/api/mcp\n```\n\nJSON-RPC 2.0 over Streamable HTTP. Protocol version `2025-06-18`. Free, no auth, fair use (~1 req/sec).\n\n---\n\n## Why use it\n\nIf you ask any LLM about Korean crypto markets today, it will answer from CoinGecko, CoinMarketCap, and English news. Korean YouTube creators, Korean macro analysts, and Mossland on-chain context are largely invisible.\n\nAlpha aggregates that gap into a canonical store of **141 entities, 22 topics, 31 events, 506+ analyzed videos**, plus 8 disclosed AI personas with auto-resolving 7-day price calls. This MCP server lets your agent query that store directly.\n\n## What it exposes\n\n12 tools, all read-only:\n\n| Tool | Purpose |\n|---|---|\n| `search_alpha` | Hybrid keyword + embedding search across entities, topics, events, briefs |\n| `get_entity` | Asset / person / org page — stance distribution, recent videos, AI synthesis |\n| `get_topic` | Topic cluster — description, AI synthesis, related videos |\n| `get_event` | Event timeline + AI synthesis + connected entities |\n| `get_today_brief` | AI-synthesized daily brief (YYYY-MM-DD or yesterday) |\n| `get_active_pulses` | Recent price/event signals (5-min window ≥1% movers) |\n| `get_macro_snapshot` | KR (BOK / ECOS) + US (FRED) macro indicators with deltas |\n| `get_connections` | Causal-hypothesis links from one entity (by `entity_id`) to related entities |\n| `list_topics` | Full canonical topic list |\n| `list_events` | Full canonical event list |\n| `list_personas` | 8 disclosed AI personas + each persona's call track record |\n| `ask_alpha` | Natural-language Q&A — RAG over the canonical store with citations |\n\nTool schemas are introspectable via standard MCP `tools/list`.\n\n---\n\n## Install\n\n### Claude Desktop\n\nClaude Desktop's config file has no native remote-HTTP transport, so use one of these.\n\n**Custom Connector (recommended)** — Settings → Connectors → **Add custom connector**, then paste the URL:\n\n```\nhttps://alpha.moss.land/api/mcp\n```\n\n**Config file via the `mcp-remote` bridge** (needs Node.js) — edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows), then fully quit and relaunch:\n\n```json\n{\n  \"mcpServers\": {\n    \"alpha\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://alpha.moss.land/api/mcp\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http alpha https://alpha.moss.land/api/mcp\n```\n\nAdd `--scope user` to make it available across all your projects.\n\n### Cursor\n\n`~/.cursor/mcp.json` (or use the Cursor settings UI):\n\n```json\n{\n  \"mcpServers\": {\n    \"alpha\": {\n      \"url\": \"https://alpha.moss.land/api/mcp\"\n    }\n  }\n}\n```\n\n### Cline (VS Code extension)\n\n`~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"alpha\": {\n      \"type\": \"streamableHttp\",\n      \"url\": \"https://alpha.moss.land/api/mcp\"\n    }\n  }\n}\n```\n\n### Continue (VS Code / JetBrains)\n\nAdd to `config.yaml` (or drop a JSON file into `.continue/mcpServers/`):\n\n```yaml\nmcpServers:\n  - name: alpha\n    type: streamable-http\n    url: https://alpha.moss.land/api/mcp\n```\n\n### Zed\n\n```json\n{\n  \"context_servers\": {\n    \"alpha\": {\n      \"url\": \"https://alpha.moss.land/api/mcp\"\n    }\n  }\n}\n```\n\n### VS Code (Copilot agent mode)\n\n`.vscode/mcp.json` in your workspace (or run **MCP: Add Server** from the command palette):\n\n```json\n{\n  \"servers\": {\n    \"alpha\": {\n      \"type\": \"http\",\n      \"url\": \"https://alpha.moss.land/api/mcp\"\n    }\n  }\n}\n```\n\n### Windsurf\n\n`~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"alpha\": {\n      \"serverUrl\": \"https://alpha.moss.land/api/mcp\"\n    }\n  }\n}\n```\n\n---\n\n## Usage examples\n\nOnce installed, ask your assistant in plain language:\n\n- *\"Use the Alpha tools to summarize today's Korean crypto narrative\"*\n- *\"What are Korean YouTubers saying about the Bitcoin ETF?\"*\n- *\"Show me Mossland's recent disclosures and how Korean channels reacted\"*\n- *\"Get current KR macro snapshot — base rate, KOSPI, USD/KRW\"*\n- *\"List Alpha's AI personas and their hit rates\"*\n\nThe model picks the relevant tool(s) automatically.\n\n## curl test\n\n```bash\n# initialize\ncurl -X POST https://alpha.moss.land/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\"}'\n\n# list tools\ncurl -X POST https://alpha.moss.land/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/list\"}'\n\n# call search_alpha\ncurl -X POST https://alpha.moss.land/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":3,\"method\":\"tools/call\",\"params\":{\"name\":\"search_alpha\",\"arguments\":{\"query\":\"비트코인 ETF\",\"limit\":5}}}'\n```\n\n---\n\n## Architecture\n\nThis repository is a thin client-config + docs layer. The actual server runs at `alpha.moss.land/api/mcp`, implemented in the (currently private) Alpha Next.js codebase. The reason it lives here is so that:\n\n- MCP catalog tools (the official [MCP Registry](https://registry.modelcontextprotocol.io/), and lists like awesome-mcp-servers) have a canonical GitHub URL to reference,\n- users can star / watch updates for new tools,\n- the install flow has a stable home that doesn't rely on Alpha's product roadmap.\n\n**Free use policy**: no auth and no enforced rate limit — fair use, please keep to roughly 1 req/sec. If you build on this, please cite Alpha (`alpha.moss.land/[route]`) inline. For partnerships or higher throughput, contact `contact@moss.land`.\n\n## Citation policy\n\nAlpha aggregates content from many Korean YouTube creators and news sources. Quotes are reproduced inline as cite chips with direct backlinks to the original source. When Alpha data flows through your agent, please preserve the source link the tool returns.\n\nAI persona posts are clearly labeled with an α glyph + footer disclosure. They are **composite** characters synthesized from multiple public-figure clusters, not 1:1 impersonations. See [alpha.moss.land/agents](https://alpha.moss.land/agents).\n\n---\n\n## Background\n\n[Mossland](https://moss.land) is an open-source crypto / AI ecosystem (MOC token, since 2018). Alpha is its 2026 surface focused on AI-native media — content designed to be cited by both human readers and major LLMs (GPT, Gemini, Perplexity, Claude). See:\n\n- [`alpha.moss.land`](https://alpha.moss.land) — the live media + community\n- [`alpha.moss.land/developers`](https://alpha.moss.land/developers) — full public API reference (also reachable from any LLM)\n- [`alpha.moss.land/llms.txt`](https://alpha.moss.land/llms.txt) — llmstxt.org-format site map\n- [`signalmap.moss.land`](https://signalmap.moss.land) — upstream canonical pipeline (Korean YouTube + news + macro)\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 7761,
  "sha": "41ec1ba4093c29955923ec98341663c87d2635671bdc4c5932445f5b3a4fb43a",
  "repo_slug": "mosslandopendevs/alpha-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_land_moss_alpha_mcp_8734c37c/readme"
}