magicpod

This MCP server bridges your AI agents with MagicPod, enabling tools and agents to contextually access MagicPod capabilities through the Model Context Protocol. By running the server with the provided npx command, you expose a server endpoint that MCP-compatible clients (like Claude Desktop or other MCP-capable tools) can query and interact with. In practice, you paste the generated configuration snippet into your client’s MCP settings to authorize and connect to the MagicPod MCP server, using your MagicPod API token for authentication.

Once connected, you can leverage the server to route prompts and context to MagicPod and receive structured responses that integrate with your AI workflows. The README demonstrates how to integrate with Claude Desktop by adding the server entry to claude_desktop_config.json, enabling seamless contextual actions, task planning, and data retrieval through MagicPod during conversations or automation tasks.

Prerequisites:

• Node.js and npm installed on your machine (Node 14+ recommended).
• Access to the MagicPod API token (generate from the integrations page).

Installation steps:

1. Ensure Node.js and npm are installed. Verify with: node -v npm -v
2. Install or run the MCP server package directly via npx (no global install required): npx -y magicpod-mcp-server --api-token=YOUR-API-TOKEN This will start the MCP server instance and print or expose configuration details for your MCP client.
3. If you prefer a local installation, clone the repository or install via npm, then build if the project requires a build step: npm install npm run build npm start (or the appropriate start command from your package.json)
4. Copy the generated mcpServers configuration into your MCP client (e.g., Claude Desktop) as shown in the README example for MacOS/Linux or Windows.
5. Replace YOUR-API-TOKEN with your actual MagicPod API token from the integrations page.

Note: If you use Windows, you may need to adapt the command to: cmd /c npx -y magicpod-mcp-server --api-token=YOUR-API-TOKEN

Tips and notes:

• Always replace YOUR-API-TOKEN with a valid MagicPod API token. Tokens can be found on the MagicPod integrations page.
• Ensure network access to MagicPod services from the host running the MCP server.
• If you’re using Claude Desktop or other MCP clients, add the server configuration to their MCP settings exactly as shown to avoid syntax issues.
• The example uses npx for on-demand execution; you can also install locally and run through npm scripts if you prefer a persistent server process.
• For Windows environments, the command can be wrapped in a cmd call as shown in the README, ensuring the same arguments are passed.
• Consider setting environment variables for token management or rotating tokens, depending on your security practices.