MCP Tools Reference
The Reedle MCP server exposes 40 tools across 9 categories. All tools are scoped to your account — they can only read and modify your own data.
Authentication
All tools use your Personal Access Token (rdk_ prefix) set via the MCP_AUTH_TOKEN environment variable. See the setup guide for configuration.
Articles
| reedle_list_articles | List saved articles. Filter by list, source type, status, starred, or archived. |
| reedle_get_article | Get metadata for a specific article including highlight and comment counts. |
| reedle_get_article_content | Get the full markdown content of an article. Use when you need to read the text. |
| reedle_create_article | Save a new article from a URL (auto-fetched) or as a plain text snippet. |
| reedle_update_article | Update article properties: title, starred, archived status. Only provided fields change. |
| reedle_delete_article | Soft-delete an article. Record is marked deleted but not permanently removed. |
| reedle_search_articles | Keyword search across article titles and content. |
| reedle_add_article_to_list | Add an article to a list. Articles can belong to multiple lists. |
| reedle_remove_article_from_list | Remove an article from a list. Article stays in library (Inbox). |
| reedle_move_article_to_inbox | Remove an article from all lists, placing it back in Inbox. |
Search
| reedle_search_semantic | AI-powered semantic search across all articles, highlights, and comments. Finds by meaning, not just keywords. |
| reedle_find_similar_articles | Find articles semantically similar to a given article based on content embeddings. |
Lists
| reedle_list_lists | List all reading lists (folders) with their article counts. |
| reedle_get_list | Get details about a specific list including article count. |
| reedle_create_list | Create a new list to organize articles. |
| reedle_update_list | Update a list's name. |
| reedle_delete_list | Delete a list. Articles are moved to Inbox, not deleted. |
Highlights
| reedle_list_highlights | List highlights. Filter by article_id for highlights from a specific article. |
| reedle_get_highlight | Get a specific highlight with article context and attached comments. |
| reedle_create_highlight | Create a highlight on an article. Requires exact text and position. |
| reedle_update_highlight | Update highlight text or position. |
| reedle_delete_highlight | Soft-delete a highlight and its associated comments. |
Processing
| reedle_process_url | Save a URL. Returns immediately with article ID — poll reedle_get_processing_status for completion. |
| reedle_get_processing_status | Check processing status of an article: queued, processing, done, or error. |
| reedle_get_youtube_transcript | Save a YouTube video with its transcript extracted. Pass URL or video ID. |
| reedle_get_bilibili_transcript | Save a Bilibili video with its transcript. Requires Bilibili authentication cookie. |
Tags
| reedle_list_tags | List all unique tags used across your library. |
| reedle_tag_article | Add or remove tags from an article. |
Flashcards
| reedle_list_decks | List all flashcard decks with card counts and due counts. |
| reedle_get_deck | Get deck details including all its cards. |
| reedle_list_cards_due | Get flashcards due for review today, sorted by due date. |
| reedle_create_card | Create a flashcard in a deck. Optionally link it to a source article. |
| reedle_review_card | Submit a card review with a rating. FSRS algorithm schedules the next review. |
| reedle_get_study_stats | Study statistics: total reviews, cards due, and learning progress. |
Credits
| reedle_get_credit_balance | Get your current credit balance. 1 credit = $0.001 USD. |
| reedle_get_credit_history | Credit usage history: operations, model used, tokens, and cost. |
Comments
| reedle_list_comments | List comments on a highlight or article. |
| reedle_create_comment | Add a comment to a highlight or article. |
| reedle_update_comment | Edit an existing comment. |
| reedle_delete_comment | Delete a comment. |
Usage examples
Once connected, ask your AI assistant in natural language:
| Ask | Tools used |
|---|---|
| "Summarize my last 5 articles" | reedle_list_articles → reedle_get_article_content × 5 |
| "Find everything I saved about LLMs" | reedle_search_semantic |
| "Create flashcards from this article's highlights" | reedle_list_highlights → reedle_create_card × n |
| "Save this YouTube video" | reedle_get_youtube_transcript |
| "How many credits do I have left?" | reedle_get_credit_balance |
| "What papers are due for review today?" | reedle_list_cards_due |