MCP Tools Reference

Overview

The Akita MCP gateway (akita-mcp.candide.me, port 8710) exposes tools across several namespaces. Each namespace corresponds to a subsystem documented in its own note.

Tool Namespaces

Corpus (corpus__*)

Vector search across the indexed knowledge base. See Corpus & Vector Search.

• corpus__search — Semantic search across all indexed content
• corpus__search_in_book — Search within a specific book title
• corpus__search_by_author — Search content by author
• corpus__search_by_tags — Search filtered by Calibre book tags
• corpus__get_chunk_context — Return a chunk with surrounding context
• corpus__get_file_chunks — List all chunks from a file path
• corpus__corpus_stats — Get corpus statistics
• corpus__reindex — Re-index sources
• corpus__get_rss_reports — Latest RSS fetch reports
• corpus__list_dossiers / corpus__get_dossier — Research dossiers on disk
• corpus__search_book_summaries — Search Calibre chapter summaries
• corpus__get_chapter_summary / corpus__get_chapter_text — Chapter content access

Readwise (readwise__*)

Reading highlights and saved documents. See Readwise.

• readwise__list_available_resources — Describe available Readwise resources
• readwise__get_reading_activity — Fetch highlights and notes for a date range
• readwise__get_documents — Fetch Reader documents by date range
• readwise__get_document_content — Full content for a specific document

Thoughts (thoughts__*)

Journal entries and summaries. See Thoughts & Journal.

• thoughts__list_thoughts — List journal entries for a date range
• thoughts__list_summaries — Cached chat summaries (week/month/quarter/year)

Health (health__*)

Apple Health data. See Health.

• health__list_available_metrics — List available health metrics with coverage
• health__get_sleep — Sleep data for a date range
• health__get_recent_summary — Daily health summary for last N days

Tracks (tracks__*)

Deep research, briefings, and signal reports. See Tracks.

• tracks__request_deep_research — Start background deep research (returns immediately)
• tracks__get_research_status — Poll research progress
• tracks__get_dossier / tracks__list_dossiers / tracks__get_dossier_tree — Dossier access
• tracks__list_deep_researches — Research request history
• tracks__list_briefing_topics / tracks__add_briefing_topic / tracks__update_briefing_topic / tracks__remove_briefing_topic — Briefing topic management
• tracks__get_latest_briefing / tracks__generate_briefing — Briefing generation
• tracks__get_signal_report / tracks__list_signal_reports / tracks__trigger_signal_report — Signal reports

Calibre (calibre__*)

Book library management. See Calibre.

• calibre__list_books — Search and list books
• calibre__get_book — Detailed book info
• calibre__list_tags — All tags with counts
• calibre__list_summary_status — Chapter/summary coverage
• calibre__extract_chapters — Extract chapters from EPUB
• calibre__list_chapters — List chapters with summary status
• calibre__get_chapter_summary — Saved AI summary for a chapter
• calibre__summarize_chapters — Generate AI summaries
• calibre__create_book_browser_artifact — Interactive HTML chapter browser

Garden (garden__*)

Content management for the digital garden. See Garden.

• Notes: create_note, get_note, update_note, list_notes, toggle_draft, toggle_private, set_image
• Fiches: create_fiche, get_fiche, update_fiche, list_fiches, delete_fiche, promote_fiche
• Resources: get_resource_entry, update_resource_entry, list_resource_entries
• Search: search_movie, search_book, search_series, search_podcast, search_person
• Create entries: create_movie_entry, create_book_entry, create_series_entry, create_podcast_entry, create_article_entry, create_person_entry
• Publishing: publish_content, get_user_guide