Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
alsk1992 avatar

Mcp

  • 12 installs
  • 610 repo stars
  • Updated June 26, 2026
  • alsk1992/cloddsbot

mcp is a Claude Code skill that manages Model Context Protocol servers and integrates their tools, resources, and prompts into the clodds agent.

About

This skill manages Model Context Protocol (MCP) servers and their tools inside the clodds bot. A developer uses it to add, connect, and restart MCP servers, then list and call their tools, resources, and prompts. It exposes both chat commands and a TypeScript client with a registry for configured servers.

  • Manage MCP servers via chat commands and a TypeScript client
  • Connect over stdio or SSE transports and call tools directly
  • Registry to add, list, start, and stop configured servers

Mcp by the numbers

  • 12 all-time installs (skills.sh)
  • Ranked #11,592 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

mcp capabilities & compatibility

Capabilities
mcp server management · tool integration · agent tooling
Use cases
orchestration
Runs
Runs locally
Pricing
Free
From the docs

What mcp says it does

Manage Model Context Protocol (MCP) servers, external tools, and AI integrations.
SKILL.md
transport: 'stdio', // 'stdio' | 'sse'
SKILL.md
npx skills add https://github.com/alsk1992/cloddsbot --skill mcp

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs12
repo stars610
Last updatedJune 26, 2026
Repositoryalsk1992/cloddsbot

What it does

Connect and manage MCP servers so an agent can call external tools like filesystem, GitHub, or Postgres.

Who is it for?

Wiring external MCP servers and their tools into the clodds agent

When should I use this skill?

You need to add, connect, or call an MCP server from the bot

What you get

Configured MCP servers are connected and their tools callable from chat or code.

By the numbers

  • 5 popular MCP servers listed (filesystem, github, postgres, brave-search, puppeteer)

Files

SKILL.mdMarkdownGitHub ↗

MCP - Complete API Reference

Manage Model Context Protocol (MCP) servers, external tools, and AI integrations.

---

Chat Commands

Server Management

/mcp list                                   List configured MCP servers
/mcp status                                 Check server connection status
/mcp add <name> <command>                   Add new MCP server
/mcp remove <name>                          Remove MCP server
/mcp restart <name>                         Restart server

Tool Interaction

/mcp tools                                  List available tools
/mcp tools <server>                         Tools from specific server
/mcp call <server> <tool> [args]            Call a tool directly
/mcp resources <server>                     List server resources

Configuration

/mcp config <server>                        View server config
/mcp config <server> set <key> <value>      Update config
/mcp logs <server>                          View server logs

---

TypeScript API Reference

Create MCP Client

import { createMCPClient } from 'clodds/mcp';

const mcp = createMCPClient({
  // Transport
  transport: 'stdio',  // 'stdio' | 'sse'

  // Server command
  command: 'npx',
  args: ['-y', '@modelcontextprotocol/server-filesystem'],

  // Options
  timeout: 30000,
  retries: 3,
});

Connect to Server

// Connect
await mcp.connect();

// Check status
const status = mcp.getStatus();
console.log(`Connected: ${status.connected}`);
console.log(`Server: ${status.serverInfo?.name}`);
console.log(`Version: ${status.serverInfo?.version}`);

// Disconnect
await mcp.disconnect();

List Tools

// Get available tools
const tools = await mcp.listTools();

for (const tool of tools) {
  console.log(`${tool.name}: ${tool.description}`);
  console.log(`  Input schema: ${JSON.stringify(tool.inputSchema)}`);
}

Call Tool

// Call a tool
const result = await mcp.callTool({
  name: 'read_file',
  arguments: {
    path: '/path/to/file.txt',
  },
});

console.log(`Result: ${JSON.stringify(result)}`);

List Resources

// Get available resources
const resources = await mcp.listResources();

for (const resource of resources) {
  console.log(`${resource.uri}: ${resource.name}`);
  console.log(`  Type: ${resource.mimeType}`);
}

// Read a resource
const content = await mcp.readResource('file:///path/to/file.txt');
console.log(content);

List Prompts

// Get available prompts
const prompts = await mcp.listPrompts();

for (const prompt of prompts) {
  console.log(`${prompt.name}: ${prompt.description}`);
}

// Get prompt content
const prompt = await mcp.getPrompt('code-review', {
  code: 'function add(a, b) { return a + b; }',
});

console.log(prompt.messages);

MCP Registry

import { createMCPRegistry } from 'clodds/mcp';

const registry = createMCPRegistry({
  configPath: './mcp-servers.json',
});

// Add server
registry.addServer({
  name: 'filesystem',
  command: 'npx',
  args: ['-y', '@modelcontextprotocol/server-filesystem', '/home/user'],
  env: {},
});

// List servers
const servers = registry.listServers();

// Get server
const server = registry.getServer('filesystem');

// Remove server
registry.removeServer('filesystem');

// Start all servers
await registry.startAll();

// Stop all servers
await registry.stopAll();

---

Popular MCP Servers

ServerPurposeInstall
filesystemFile operations@modelcontextprotocol/server-filesystem
githubGitHub API@modelcontextprotocol/server-github
postgresDatabase queries@modelcontextprotocol/server-postgres
brave-searchWeb search@modelcontextprotocol/server-brave-search
puppeteerBrowser automation@modelcontextprotocol/server-puppeteer

---

Server Configuration

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user"],
      "env": {}
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    }
  }
}

---

CLI Commands

# List MCP servers
clodds mcp list

# Add MCP server
clodds mcp add filesystem "npx -y @modelcontextprotocol/server-filesystem /home"

# Test server connection
clodds mcp test filesystem

# Remove server
clodds mcp remove filesystem

---

Best Practices

1. Use official servers — Start with well-tested MCP servers 2. Limit file access — Restrict filesystem server to specific directories 3. Secure credentials — Use env vars for tokens, not command args 4. Monitor logs — Check server logs for errors 5. Timeout handling — Set appropriate timeouts for slow operations

Related skills

FAQ

What transports does the MCP client support?

The client supports stdio and sse transports, configured on createMCPClient.

How do I add a new MCP server?

Use /mcp add <name> <command> or registry.addServer, or add it to mcp-servers.json.

AI & Agent Buildingagentsautomation

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.