Acornonaut MCP Server

MCP

Acornonaut is AI-powered video learning: turn YouTube playlists into high-quality flashcards, then query your learning library directly from any MCP-compatible AI client.

This repository is a thin public wrapper for the hosted Acornonaut MCP endpoint (no server source code).

Endpoint

Transport: Streamable HTTP
URL: https://acornonaut.app/api/mcp
Full docs: https://acornonaut.app/docs/mcp

Authentication

Use your Acornonaut API key in either header:

Authorization: Bearer <your_api_key> (recommended)
x-api-key: <your_api_key>

Keep your API key secret. Never commit it to source control.

Quick Connect

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "acornonaut": {
      "url": "https://acornonaut.app/api/mcp",
      "headers": {
        "Authorization": "Bearer ak_your_api_key_here"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "acornonaut": {
      "url": "https://acornonaut.app/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer ak_your_api_key_here"
      }
    }
  }
}

Windsurf

Use MCP Server settings and provide:

Name: acornonaut
URL: https://acornonaut.app/api/mcp
Transport: streamable-http
Header: Authorization: Bearer ak_your_api_key_here

Or JSON form:

{
  "mcpServers": {
    "acornonaut": {
      "url": "https://acornonaut.app/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer ak_your_api_key_here"
      }
    }
  }
}

VS Code (MCP-compatible extensions)

For MCP extensions that accept JSON config:

{
  "mcpServers": {
    "acornonaut": {
      "url": "https://acornonaut.app/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer ak_your_api_key_here"
      }
    }
  }
}

OpenClaw / mcporter

OpenClaw-style config snippet

{
  "mcpServers": {
    "acornonaut": {
      "url": "https://acornonaut.app/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer ak_your_api_key_here"
      }
    }
  }
}

mcporter example

mcporter call acornonaut list_playlists '{}'

Tool Reference

Acornonaut currently exposes the following MCP tools:

Tool	Parameters	Description
`list_playlists`	`page?: number`, `limit?: number`	List your playlists with status and pagination.
`get_playlist`	`id: string`	Get one playlist with videos and associated cards.
`create_playlist`	`url: string`	Create a playlist from a YouTube URL and start processing.
`get_cards`	`playlistId: string`, `page?: number`, `limit?: number`	Fetch paginated flashcards for a playlist.
`search_cards`	`query: string`, `limit?: number`	Full-text search across your flashcards.
`get_quota`	none	Check plan limits and current usage/quota status.
`export_deck`	`playlistId: string`, `format?: "apkg"	"csv"

Example (curl)

curl -s -X POST https://acornonaut.app/api/mcp \
  -H "Authorization: Bearer ak_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "list_playlists",
      "arguments": { "page": 1, "limit": 10 }
    }
  }'

Why Acornonaut 🎯

Turn long-form YouTube learning into active recall
Build reusable knowledge decks from playlists
Query and review knowledge from your AI tools

Acornonaut MCP Server