Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PORTNoHTTP port when using HTTP transport.3000
KAVITA_URLYesRequired. Self-hosted Kavita origin, http or https, no userinfo, query, or hash. Hosts on kavitareader.com and its subdomains are refused. There is no default base URL.
MCP_TRANSPORTNoTransport mode: stdio or http. --http overrides this.
KAVITA_API_KEYNoAuth Key from User Settings. Sent as the x-api-key header. Can be used instead of KAVITA_USERNAME and KAVITA_PASSWORD.
KAVITA_CONTACTNoContact token in the User-Agent. Must not contain the key or password.
KAVITA_PASSWORDNoPassword for the KAVITA_USERNAME login. The connector posts /api/Account/login once and refreshes the JWT once after a 401.
KAVITA_TOOLSETSNoComma list of toolsets, or all. Default is the read-focused set.
KAVITA_USERNAMENoOptional login username. Set together with KAVITA_PASSWORD when no Auth Key is set.
KAVITA_PER_MINUTENoLocal request budget. Cache hits do not spend it.30
KAVITA_TIMEOUT_MSNoUpstream timeout in milliseconds.20000
KAVITA_ALLOW_WRITESNoMust be the literal true before a confirmed write is sent. The string "true" is rejected.
KAVITA_CACHE_TTL_SECNoRead cache TTL in seconds. Writes clear the cache.60

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
kavita_chapterA

kavita_chapter covers the chapter toolset (5 operations). Auth is the x-api-key header, or a JWT from KAVITA_USERNAME and KAVITA_PASSWORD. Self-hosted Kavita only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KAVITA_ALLOW_WRITES=true. Omit confirm for a dry-run preview that sends nothing. Destructive, credential, or exposure actions add an extra warning in the preview and here: delete, scan, analyze, refresh, cache clear, cleanup, user or role changes, Auth Key create or revoke, password reset, settings, license, scrobbling tokens, OAuth or OIDC, and email. Actions: delete, get, get_chapter_detail_plus, post_delete_multiple, post_update.

kavita_collectionA

kavita_collection covers the collection toolset (12 operations). Auth is the x-api-key header, or a JWT from KAVITA_USERNAME and KAVITA_PASSWORD. Self-hosted Kavita only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KAVITA_ALLOW_WRITES=true. Omit confirm for a dry-run preview that sends nothing. Destructive, credential, or exposure actions add an extra warning in the preview and here: delete, scan, analyze, refresh, cache clear, cleanup, user or role changes, Auth Key create or revoke, password reset, settings, license, scrobbling tokens, OAuth or OIDC, and email. Actions: delete, get, get_all_series, get_mal_stacks, get_name_exists, get_single, post_delete_multiple, post_import_stack, post_promote_multiple, post_update, post_update_for_series, post_update_series.

kavita_libraryA

kavita_library covers the library toolset (23 operations). Auth is the x-api-key header, or a JWT from KAVITA_USERNAME and KAVITA_PASSWORD. Self-hosted Kavita only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KAVITA_ALLOW_WRITES=true. Omit confirm for a dry-run preview that sends nothing. Destructive, credential, or exposure actions add an extra warning in the preview and here: delete, scan, analyze, refresh, cache clear, cleanup, user or role changes, Auth Key create or revoke, password reset, settings, license, scrobbling tokens, OAuth or OIDC, and email. Actions: delete_delete, delete_delete_multiple, get, get_jump_bar, get_libraries, get_list, get_metadata_enabled_libraries, get_metadata_providers, get_name_exists, get_scrobble_enabled_libraries, get_type, get_user_libraries, post_copy_settings_from, post_create, post_grant_access, post_has_files_at_root, post_refresh_metadata, post_refresh_metadata_multiple, post_scan, post_scan_all, post_scan_folder, post_scan_multiple, post_update.

kavita_metadataA

kavita_metadata covers the metadata toolset (14 operations). Auth is the x-api-key header, or a JWT from KAVITA_USERNAME and KAVITA_PASSWORD. Self-hosted Kavita only. action help with target returns one action's parameters. Actions: get_age_ratings, get_all_bcp47_languages, get_all_languages, get_genres, get_language_title, get_languages, get_people, get_people_by_role, get_publication_status, get_readinglist_tags, get_series_detail_plus, get_tags, post_genres_with_counts, post_tags_with_counts.

kavita_personA

kavita_person covers the person toolset (10 operations). Auth is the x-api-key header, or a JWT from KAVITA_USERNAME and KAVITA_PASSWORD. Self-hosted Kavita only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KAVITA_ALLOW_WRITES=true. Omit confirm for a dry-run preview that sends nothing. Actions: get, get_chapters_by_role, get_roles, get_search, get_series_known_for, post_all, post_fetch_cover, post_merge, post_update, post_valid_alias.

kavita_readinglistA

kavita_readinglist covers the readinglist toolset (27 operations). Auth is the x-api-key header, or a JWT from KAVITA_USERNAME and KAVITA_PASSWORD. Self-hosted Kavita only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KAVITA_ALLOW_WRITES=true. Omit confirm for a dry-run preview that sends nothing. Destructive, credential, or exposure actions add an extra warning in the preview and here: delete, scan, analyze, refresh, cache clear, cleanup, user or role changes, Auth Key create or revoke, password reset, settings, license, scrobbling tokens, OAuth or OIDC, and email. Actions: delete, get, get_all_people, get_info, get_items, get_lists_for_chapter, get_lists_for_series, get_name_exists, get_next_chapter, get_people, get_prev_chapter, post_all, post_create, post_delete_item, post_delete_multiple, post_export_as_cbl, post_lists, post_promote_multiple, post_regenerate_cover, post_remove_read, post_update, post_update_by_chapter, post_update_by_multiple, post_update_by_multiple_series, post_update_by_series, post_update_by_volume, post_update_position.

kavita_searchA

kavita_search covers the search toolset (4 operations). Auth is the x-api-key header, or a JWT from KAVITA_USERNAME and KAVITA_PASSWORD. Self-hosted Kavita only. action help with target returns one action's parameters. Actions: get_chapters_by_series, get_search, get_series_for_chapter, get_series_for_mangafile.

kavita_seriesA

kavita_series covers the series toolset (33 operations). Auth is the x-api-key header, or a JWT from KAVITA_USERNAME and KAVITA_PASSWORD. Self-hosted Kavita only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KAVITA_ALLOW_WRITES=true. Omit confirm for a dry-run preview that sends nothing. Destructive, credential, or exposure actions add an extra warning in the preview and here: delete, scan, analyze, refresh, cache clear, cleanup, user or role changes, Auth Key create or revoke, password reset, settings, license, scrobbling tokens, OAuth or OIDC, and email. Actions: delete, get, get_age_rating, get_all_related, get_chapter, get_currently_reading, get_external_series_detail, get_match_info, get_metadata, get_next_expected, get_related, get_series_by_collection, get_series_detail, get_series_with_annotations, get_volume, get_volumes, post_all_v2, post_analyze, post_delete_multiple, post_dont_match, post_match, post_metadata, post_on_deck, post_recently_added_v2, post_recently_updated_series, post_refresh_metadata, post_remove_from_on_deck, post_scan, post_series_by_ids, post_update, post_update_match, post_update_related, post_v2.

kavita_serverA

kavita_server covers the server toolset (17 operations). Auth is the x-api-key header, or a JWT from KAVITA_USERNAME and KAVITA_PASSWORD. Self-hosted Kavita only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KAVITA_ALLOW_WRITES=true. Omit confirm for a dry-run preview that sends nothing. Destructive, credential, or exposure actions add an extra warning in the preview and here: delete, scan, analyze, refresh, cache clear, cleanup, user or role changes, Auth Key create or revoke, password reset, settings, license, scrobbling tokens, OAuth or OIDC, and email. Actions: get_changelog, get_check_for_updates, get_check_out_of_date, get_check_update, get_is_task_running, get_jobs, get_media_errors, get_server_info_slim, post_analyze_files, post_backup_db, post_bust_kavitaplus_cache, post_cleanup, post_cleanup_want_to_read, post_clear_cache, post_clear_media_alerts, post_convert_media, post_sync_themes.

kavita_statsA

kavita_stats covers the stats toolset (33 operations). Auth is the x-api-key header, or a JWT from KAVITA_USERNAME and KAVITA_PASSWORD. Self-hosted Kavita only. action help with target returns one action's parameters. Actions: get_avg_time_by_hour, get_day_breakdown, get_device_client_type, get_device_device_type, get_favorite_authors, get_files_added_over_time, get_genre_breakdown, get_most_active_users, get_page_spread, get_pages_per_year, get_popular_decades, get_popular_genres, get_popular_libraries, get_popular_people, get_popular_reading_list, get_popular_series, get_popular_tags, get_reading_activity, get_reading_counts, get_reading_history, get_reading_history_series, get_reading_pace, get_reads_by_month, get_server_count_manga_format, get_server_count_publication_status, get_server_file_breakdown, get_server_stats, get_tag_breakdown, get_total_reads, get_user_read, get_user_stats, get_word_spread, get_words_per_year.

kavita_volumeA

kavita_volume covers the volume toolset (4 operations). Auth is the x-api-key header, or a JWT from KAVITA_USERNAME and KAVITA_PASSWORD. Self-hosted Kavita only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KAVITA_ALLOW_WRITES=true. Omit confirm for a dry-run preview that sends nothing. Destructive, credential, or exposure actions add an extra warning in the preview and here: delete, scan, analyze, refresh, cache clear, cleanup, user or role changes, Auth Key create or revoke, password reset, settings, license, scrobbling tokens, OAuth or OIDC, and email. Actions: delete, get, post_multiple, post_update.

kavita_wanttoreadA

kavita_wanttoread covers the wanttoread toolset (4 operations). Auth is the x-api-key header, or a JWT from KAVITA_USERNAME and KAVITA_PASSWORD. Self-hosted Kavita only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KAVITA_ALLOW_WRITES=true. Omit confirm for a dry-run preview that sends nothing. Actions: get, post_add_series, post_remove_series, post_v2.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.8/5.0

Scored across 12 tools

Disambiguation3/5

The 12 tools split cleanly by resource (library, series, volume, chapter, collection, readinglist, etc.), so the top-level choice is usually obvious. However, actions bleed across resources: chapter lookups appear in kavita_chapter, kavita_series (get_chapter), kavita_search (get_chapters_by_series) and kavita_readinglist, and generic actions like `get`, `delete`, and `get_name_exists` repeat in several tools with different targets. An agent must read descriptions carefully to pick the right tool for cross-cutting queries.

Naming Consistency4/5

All 12 tool names follow a clean `kavita_<resource>` pattern, making the set easy to scan. The inconsistency is one level down: actions mix HTTP-verb prefixes (`get_`, `post_`, `delete_`), producing oddities like `delete_delete`, `post_all_v2`, and `post_delete_multiple`, which read as leaked route names rather than a deliberate verb_noun convention.

Tool Count5/5

Twelve tools is squarely in the well-scoped range and maps to the natural domain entities of a self-hosted manga/comic server. The heavy lifting is pushed into per-tool `action` parameters, keeping the top-level surface small without collapsing unrelated resources into one god-tool.

Completeness4/5

Core library lifecycle is well covered: create/update/delete for library, series, volume, chapter, collection, and readinglist, plus search, metadata, people, stats, and server maintenance. Gaps exist around user/role administration, auth keys, settings, scrobbling/OAuth, and email — all referenced in the write-warning boilerplate but with no corresponding toolset — and annotation handling is read-only.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues