AlphaGrowth MCP API

openapi: 3.2.0
info:
  version: 0.1.0
  description: 'AlphaGrowth is a crypto growth firm that grows protocols'' TVL and liquidity and publishes free data. Public, unauthenticated, read-only access to AlphaGrowth''s crypto and web3 data: a Model Context Protocol server over the Twitter/X Spaces search history and transcripts, CSV exports of the data tables, and every page as Markdown. The data API under /api/v1 (also MCP tools) is free, and each response carries a source block to cite. Guide: https://alphagrowth.io/llms.txt'
  title: AlphaGrowth MCP API
servers:
- url: https://alphagrowth.io
security: []
tags:
- name: MCP
paths:
  /mcp:
    get:
      summary: 'Not offered: the server is stateless and opens no SSE stream'
      operationId: mcpStream
      responses:
        '405':
          description: Method not allowed — POST JSON-RPC instead
      tags:
      - MCP
    delete:
      summary: 'Not offered: sessions hold no server state to end'
      operationId: mcpTerminate
      responses:
        '405':
          description: Method not allowed — there is no session to end
      tags:
      - MCP
    post:
      description: 'Send `initialize`, `tools/list` and `tools/call` messages (a single message or a batch). Protocol versions: 2025-06-18, 2025-03-26. Tools:


        - `list_keywords`: The keywords whose results are tracked. Returns each keyword''s id, the text searched, whether it is still being searched, when it was last searched, and how many results it has found. Use an id as the `keyword_id` argument of search_results. - `list_sources`: The sources that have produced results, for example twitter_spaces, tweets_en or tweets_ja. Use one as the `source` argument of search_results. - `search_results`: Recorded search results, newest first. Filter by keyword, by source, and by free text scoped to result titles, to the transcripts of imported Twitter Spaces, or to both. Each entry reports its source, url, title, author, state and datetime, plus whether a transcript is available and the broadcast_id to pass to get_transcript. - `get_transcript`: The full transcript of an imported Twitter Space, by the broadcast_id that search_results reports. Returns the title, start time, duration, participants, audio url when published, and the transcript as timed segments with their speaker. - `list_transcribed_spaces`: Twitter Spaces among the matching results whose import produced a transcript, one entry per broadcast with the keywords that found it. Takes the same filters as search_results. Use it to find transcripts worth fetching with get_transcript. - `find_projects`: Finds crypto projects whose name or symbol contains the query, largest TVL first, with slug, category, TVL and market cap. Includes blockchains'' own projects (flagged `is_chain`: true; use chain_metrics for the chain, project_metrics for its coin). Use the slug with the other project tools. Free data from AlphaGrowth (alphagrowth.io). - `project_metrics`: A crypto project''s current metrics from AlphaGrowth: TVL, price, market cap, volume, revenue, users and social followers with 1d/7d/30d changes, plus its description, categories, chains and links. Free data from AlphaGrowth (alphagrowth.io). - `project_community`: How fast a crypto project''s community is growing: followers or members per network (X/Twitter, Telegram, Discord, Reddit) with 1d/7d/30d percent changes and one point per day for up to 90 days. Free data from AlphaGrowth (alphagrowth.io). - `rank_projects`: Ranks crypto projects by a metric such as TVL, market cap, price, revenue or followers (or its 1d/7d/30d change), optionally within a category or chain, 50 per page. Sub-projects such as Aave V2 and Aave V3 rank as their own rows beside their parent. Free data from AlphaGrowth (alphagrowth.io). - `project_funding`: A crypto project''s funding rounds (oldest first, with date, amount, type and valuation where known), the investors behind them and the total raised. Free data from AlphaGrowth (alphagrowth.io). - `recent_funding_rounds`: The most recent crypto funding rounds, newest first, with project, category, amount, type and investors, optionally within a category, 50 per page. Free data from AlphaGrowth (alphagrowth.io). - `top_investors`: The top 100 crypto investors ranked by number of projects funded or by total amount invested, with their first 20 funded projects (projects_more counts the rest), 50 per page. Free data from AlphaGrowth (alphagrowth.io). - `investor_profile`: A crypto investor''s public profile (type, location, website, industries, investment criteria) and its investments, newest first, 50 per page. Free data from AlphaGrowth (alphagrowth.io). - `chains`: Blockchains ranked by TVL with price, market cap, 1d/7d TVL change and how many projects run on each, 50 per page. Use a chain''s slug with chain_metrics and its chain_slug as the chain filter of rank_projects. Free data from AlphaGrowth (alphagrowth.io). - `chain_metrics`: A blockchain''s metrics as on AlphaGrowth''s chain compare page.'
      summary: MCP JSON-RPC 2.0 (Streamable HTTP, stateless)
      operationId: mcp
      responses:
        '200':
          description: 'JSON-RPC response (an array for a batch). An `initialize` answer carries `Mcp-Session-Id`: the client''s name and version, signed — send it back on later requests so calls are attributed to the client; the server keeps no session state.'
          headers:
            Mcp-Session-Id:
              description: 'On an `initialize` answer: the client''s name and version, signed'
              schema:
                type: string
          content:
            application/json:
              schema:
                type:
                - object
                - array
        '202':
          description: 'Notifications only: no response body'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JsonRpcRequest'
      tags:
      - MCP
components:
  schemas:
    JsonRpcRequest:
      type: object
      required:
      - jsonrpc
      - method
      properties:
        id:
          type:
          - string
          - integer
          - 'null'
        params:
          type: object
        method:
          type: string
          examples:
          - initialize
          - tools/list
          - tools/call
        jsonrpc:
          const: '2.0'
          type: string
externalDocs:
  description: llms.txt
  url: https://alphagrowth.io/llms.txt