MCP Catalogs
← Home

motoko-mcp-example

by prometheus-protocol·★ 1·Score 31

A Motoko template for creating Prometheus Protocol MCP servers with one-click deployment on ICP Ninja.

developer-toolsblockchainother
0
Forks
0
Open issues
9 mo ago
Last commit
2d ago
Indexed

Overview

This repository provides a complete, ready-to-deploy Motoko MCP server template for the Prometheus Protocol ecosystem. It's specifically optimized for deployment on the ICP Ninja online IDE, offering both temporary testing deployments and permanent canister publishing options. The template includes a default 'get_weather' tool and comprehensive documentation for local development, monetization through OAuth, and publishing to the Prometheus App Store.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Building custom MCP tools for the Internet Computer blockchain
you:Creating monetized AI services with OAuth authentication
you:Developing and testing MCP servers in a browser-based IDE
you:What is the difference between temporary and permanent deployment?
you:How do I add custom tools to my MCP server?

When to choose this

Choose this when developing MCP servers for the Internet Computer ecosystem, especially when you want quick prototyping without local setup or when planning to monetize through the Prometheus Protocol.

When NOT to choose this

Don't choose this if you need to deploy outside the Internet Computer ecosystem or if you prefer traditional development environments over the specialized ICP Ninja workflow.

Tools this server exposes

2 tools extracted from the README
  • get_weather

    Gets the weather information (always sunny in this example)

  • echo

    Echoes back the input message

Comparable tools

motoko-sdkicp-canister-templatedfx-template

Installation

Quick Deployment (No Local Setup Required)

  1. Visit the ICP Ninja deployment link: https://icp.ninja/i?s=wOrZM
  2. Click the **Run** button for temporary deployment (45 minutes) or **Publish** for permanent deployment
  3. Copy the canister ID from the deployment output
  4. Test your server with the MCP Inspector using the URL format: https://[YOUR_CANISTER_ID].icp0.io/mcp

Local Development Setup

  1. Install prerequisites:

- DFX (Canister SDK) - Node.js (v18.0+) - MOPS (Motoko Package Manager)

  1. Clone the repository
  2. Deploy locally: dfx deploy or npm run deploy

Claude Desktop Integration

Add to your Claude Desktop config.json:

{
  "mcpServers": {
    "motoko-mcp": {
      "command": "dfx",
      "args": ["start", "--host", "127.0.0.1", "--port", "8000"]
    }
  }
}

FAQ

What is the difference between temporary and permanent deployment?
Temporary deployments via the 'Run' button are free but last only 45 minutes. Permanent deployments via 'Publish' require an ICP account and cycles to power the canister but persist indefinitely.
How do I add custom tools to my MCP server?
Open `src/main.mo` to see how the default tools are implemented. The file contains comments and examples to guide you in creating your own custom MCP tools by adding new functions and exposing them through the server.

Compare motoko-mcp-example with

motoko-mcp-example vs mcp-server-chartmotoko-mcp-example vs everythingmotoko-mcp-example vs filesystemmotoko-mcp-example vs timemotoko-mcp-example vs sequentialthinking
GitHub →

Last updated · Auto-generated from public README + GitHub signals.