KosmoKrator

data

Mastodon MCP, CLI, and Lua Integration for AI Agents

Mastodon integration docs for AI agents: MCP gateway setup, Mastodon CLI commands, Lua API reference, credentials, and function schemas.

Mastodon for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Agent Surfaces

Mastodon CLIHeadless setup, JSON output, direct function calls. Mastodon MCPExpose selected tools to local MCP clients. Mastodon LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug
mastodon
route_slug
mastodon
package
mastodon
auth_strategy
bearer_token
cli_setup_supported
true
cli_runtime_supported
true
mcp_gateway_supported
true
lua_supported
true

Function Catalog

FunctionTypeParametersDescription
mastodon.mastodon_list_statuses Read read 4 Browse statuses (toots) from a Mastodon timeline. Use "home" for your home feed, "public" for the federated timeline, or "local" for the local instance timeline. Supports pagination.
mastodon.mastodon_get_status Read read 1 Retrieve a single Mastodon status (toot) by its ID. Returns the full post content, author details, and engagement metrics.
mastodon.mastodon_create_status Write write 6 Publish a new status (toot) on Mastodon. Supports content warnings, visibility controls (public, unlisted, private, direct), replies, and language settings.
mastodon.mastodon_list_accounts Read read 3 List followers of a Mastodon account. Returns account profiles with display names, bios, and follower counts. Supports pagination.
mastodon.mastodon_get_account Read read 1 Retrieve a Mastodon account profile by ID. Returns display name, bio, follower counts, and other profile details.
mastodon.mastodon_get_current_user Read read 0 Get the authenticated user's Mastodon profile. Returns display name, bio, follower/following counts, and other account details.
mastodon.mastodon_api_get Read read 2 Call any Mastodon GET API endpoint relative to the configured instance, such as /api/v1/notifications.
mastodon.mastodon_api_post Write write 2 Call any Mastodon POST API endpoint relative to the configured instance.
mastodon.mastodon_api_put Write write 2 Call any Mastodon PUT API endpoint relative to the configured instance.
mastodon.mastodon_api_delete Write write 2 Call any Mastodon DELETE API endpoint relative to the configured instance.