@furlow/mcp

@furlow/mcp

Model Context Protocol server that lets LLM clients author FURLOW Discord bot specs without hallucinating action names, event names, or config shapes.

Quick start

Add to your client's MCP config. For Claude Desktop, edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "furlow": {
      "command": "npx",
      "args": ["-y", "@furlow/mcp"]
    }
  }
}

Restart the client. The model will now see five FURLOW tools.

Tools

Tool	Purpose
validate_spec	Validate a YAML spec against the real FURLOW schema. Returns structured errors.
list_actions	The 85 canonical action names.
list_events	The canonical event names the runtime emits.
list_builtins	The 14 builtin modules and what they do.
scaffold_bot	Generate a minimal valid YAML spec, optionally with builtins.

Programmatic use

import { createServer, validateSpec, scaffoldBot } from '@furlow/mcp';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

const server = createServer();
await server.connect(new StdioServerTransport());

Or call the helpers directly:

import { validateSpec, scaffoldBot, FURLOW_ACTIONS } from '@furlow/mcp';

console.log(validateSpec(yamlBody));          // { valid, errors }
console.log(scaffoldBot({ name: 'My Bot' })); // yaml string
console.log(FURLOW_ACTIONS);                  // string[]

License

MIT