Octo MCP

Develop and extend the OctoMesh MCP server (octo-mcp-service) — the Model Context Protocol server exposing ~181 tools that mirror octo-cli plus generic CK CRUD and aggregation/stream-data queries, used by AI assistants to administer OctoMesh tenants without the CLI or GraphQL. Use when adding or modifying MCP tools, classifying tool risk, wiring *ClientContext helpers, building file-transfer flows, or following the mandatory test conventions. Trigger on: MCP tool development, octo-mcp-service, adding MCP tools, McpRisk, MCP server, model context protocol server work in OctoMesh.

10 starsAI, LLMs & Agents Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add meshmakers/octo-claude-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add meshmakers/octo-claude-skills --skill octo-mcp
Manual install
git clone --depth 1 https://github.com/meshmakers/octo-claude-skills.git /tmp/octo-claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/octo-claude-skills/skills/octo-mcp ~/.claude/skills/octo-mcp

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# OctoMesh MCP Server Development

## Purpose

Guide for developing and extending **`octo-mcp-service`** (`C:\dev\meshmakers\octo-mcp-service`), the OctoMesh **Model Context Protocol** server. It exposes **~177 tools** (181 distinct `[McpServerTool]` methods today) that mirror the full `octo-cli` command surface plus generic CK-type CRUD and aggregation/stream-data queries. AI assistants connect over HTTP and administer tenants — identity, blueprints, communication, time-series, reporting, file transfer — without invoking the CLI or writing GraphQL.

This skill is for **working on the server itself** (adding/changing tools), not for *using* it as a client. The single most valuable workflow is the **Adding a New Tool checklist** below.

**Ground truth lives in the repo's own `CLAUDE.md`** — it is rich and authoritative. Read it before any substantial change. This skill is the fast operational overview that points at the right conventions.

## The Three Tool Families

Know which family you are touching before you write code — they have different code paths, conventions, and cost profiles, and must not be merged.

| Family | Talks to | Helper pattern | Lives in |
|---|---|---|---|
| **1. Platform-admin** | Backend services over HTTP via `Meshmakers.Octo.Sdk.ServiceClient` | `*ClientContext.TryBuild` | most `Tools/*Tools.cs` |
Read the full skill on GitHub

Details

Skill name
octo-mcp
Path
skills/octo-mcp/SKILL.md
Repo updated
17 November 2026

FAQ

What does the Octo MCP skill do?

Develop and extend the OctoMesh MCP server (octo-mcp-service) — the Model Context Protocol server exposing ~181 tools that mirror octo-cli plus generic CK CRUD and aggregation/stream-data queries, used by AI assistants to administer OctoMesh tenants without the CLI or GraphQL. Use when adding or modifying MCP tools, classifying tool risk, wiring *ClientContext helpers, building file-transfer flows, or following the mandatory test conventions. Trigger on: MCP tool development, octo-mcp-service, adding MCP tools, McpRisk, MCP server, model context protocol server work in OctoMesh.

How do I install the Octo MCP skill?

Claude Code plugin: /plugin marketplace add meshmakers/octo-claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Octo MCP popular?

It lives in meshmakers/octo-claude-skills, which has 10 GitHub stars and 0 forks.

Related skills

Octo

10

meshmakers/octo-claude-skills

Primary entry point and router for ALL OctoMesh tasks. Drives the octo-cli for platform administration (users, roles, groups, tenants, clients, identity providers, blueprints, CK catalog/library management, stream-data archives, communication adapters/pipelines, AI services) and explores the data model and runtime instances via GraphQL. Routes specialized work to sibling skills. When unsure which OctoMesh skill to use, start here. Trigger on: OctoMesh, octo-cli, CLI command, environment switch, auth/login, AuthStatus, tenant, temporary tenant, test tenant, user, role, group, client credentials

Software Development

Octo Agent

10

meshmakers/octo-claude-skills

Debugging and investigation agent for OctoMesh — diagnoses CK model failures (ResolveFailed, modelState 2, broken dependencies, version-bump cascades), blueprint install failures, and CK migration problems; inspects MongoDB tenant databases directly; runs selective DebugL builds and targeted tests to isolate a regression; and manages Docker volume backups for safe rollback. Use it when something broke after a build, version bump, merge, or upgrade and you need to find the root cause safely. Trigger on: help me fix, investigate this bug, what broke, isolate the issue, why is the model broken, R

AI, LLMs & Agents

Octo App Builder

10

meshmakers/octo-claude-skills

Build a complete OctoMesh-powered application end to end — a custom Construction Kit data model published to the CK catalog, an HTTP API made of dataflow pipelines on the tenant's Mesh Adapter, an optional containerized web app the Communication Operator rolls out to Kubernetes, and a blueprint that packages all of it so a single InstallBlueprint provisions any tenant. Encodes the verified build sequence (model → pipelines → app image → blueprint → install → deploy → verify) and the pitfalls that silently break it (blueprint catalog cache, pipeline registration rotation, HTTP response shaping,

DevOps & Cloud

Build MCP App

9

Vincent-the-gamer/skills

This skill should be used when the user wants to build an "MCP app", add "interactive UI" or "widgets" to an MCP server, "render components in chat", build "MCP UI resources", make a tool that shows a "form", "picker", "dashboard" or "confirmation dialog" inline in the conversation, or mentions "apps SDK" in the context of MCP. Use AFTER the build-mcp-server skill has settled the deployment model, or when the user already knows they want UI widgets.

AI, LLMs & Agents

Octo Logs Setup

10

meshmakers/octo-claude-skills

One-time setup and health check of the Dash0 MCP connection that /octo-logs relies on to read OctoMesh cluster logs. Walks through registering the Dash0 MCP server in Claude Code, the browser OAuth login via /mcp, and verifies access with listDatasets. Replaces the former Loki credential setup (LOKI_USERNAME / LOKI_PASSWORD) — Loki no longer exists; old LOKI_* variables can be deleted from the private profile. Run this when the mcp__dash0__* tools are missing or return auth errors. Trigger on: set up log access, configure log access, octo-logs setup, Dash0 MCP, dash0 tools missing, mcp__dash0

AI, LLMs & Agents

Build MCP Server

9

Vincent-the-gamer/skills

This skill should be used when the user asks to "build an MCP server", "create an MCP", "make an MCP integration", "wrap an API for Claude", "expose tools to Claude", "make an MCP app", or discusses building something with the Model Context Protocol. It is the entry point for MCP server development — it interrogates the user about their use case, determines the right deployment model (remote HTTP, MCPB, local stdio), picks a tool-design pattern, and hands off to specialized skills.

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.