Tusky MCP Server 🦣

What is Tusky MCP Server 🦣?

The Tusky MCP Server bridges Tusky storage and Mastodon integration with AI assistants using the Model Context Protocol (MCP). It lets Claude and other MCP-compatible AI systems securely access and manipulate data in Tusky through a standardized interface.

How to use Tusky MCP Server 🦣?

Clone the repository, run npm install, create a .env file with your Tusky API key and API URL, then build with npm run build and start with npm start. Configure the server in MCP clients like Claude Desktop or Cursor using a command that points to the built index.js and sets the TUSKY_API_KEY and TUSKY_API_URL environment variables.

Key features of Tusky MCP Server 🦣

• Authentication with the Tusky API
• File and folder management in Tusky vaults
• User profile and storage management
• Search across vaults, folders, and files
• Reliable file uploads using the TUS protocol
• Seamless integration with Claude Desktop and Cursor

Use cases of Tusky MCP Server 🦣

• Allow Claude to list, create, and modify storage vaults
• Organize content with folders via natural language commands
• Upload and manage files with resumable TUS transfers
• Search for files across all vaults from an AI assistant
• Manage Tusky user profile and settings through chat

FAQ from Tusky MCP Server 🦣

What are the prerequisites to run the server?

You need Node.js v20 or higher, a Tusky API key, and an MCP client like Claude Desktop or Cursor.

How do I configure Tusky MCP Server with Claude Desktop?

Add a server entry to claude_desktop_config.json with the command node and the path to build/index.js, plus the environment variables TUSKY_API_KEY and TUSKY_API_URL.

How do I configure Tusky MCP Server with Cursor?

In Cursor Settings, go to Features > MCP Servers, add a new server with type “command” and enter the full command including environment variables and the path to build/index.js.

How does authentication work?

Authentication uses an API key stored in the environment variable TUSKY_API_KEY. You obtain this key from your Tusky account.

What transport does the server use?

The server communicates over stdio, configured as a command-based MCP server for clients like Claude Desktop.