From botster
Use when exposing MCP tools, prompts, or resource templates from Botster Lua plugins.
How this skill is triggered — by the user, by Claude, or both
Slash command
/botster:botster-customize-mcpThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Botster Lua plugins register MCP tools and prompts through `lib.mcp`. Agents
Botster Lua plugins register MCP tools and prompts through lib.mcp. Agents
connect to them through the single botster MCP server configured by this
agent plugin.
mcp.tool("tool_name", {
description = "One-line description shown to the agent",
input_schema = {
type = "object",
properties = {
file = { type = "string", description = "Path to read" },
limit = { type = "number", description = "Max results" },
},
required = { "file" },
},
}, function(params, context)
return {
file = params.file,
session_uuid = context.session_uuid,
}
end)
The MCP context includes the calling session_uuid and hub_id. Use that
context for caller-scoped behavior; do not let a caller drain another agent's
private inbox unless the tool is explicitly administrative.
mcp.prompt("hub-context", {
description = "Inject current hub state",
arguments = {
{ name = "focus", description = "Optional focus area", required = false },
},
}, function(args)
return {
description = "Current Botster hub state",
messages = {
{
role = "user",
content = {
type = "text",
text = "Hub context goes here",
},
},
},
}
end)
mcp.tool(name, schema, handler)mcp.remove_tool(name)mcp.list_tools()mcp.call_tool(name, params, context)mcp.count()mcp.prompt(name, schema, handler)mcp.remove_prompt(name)mcp.list_prompts()mcp.get_prompt(name, args)mcp.count_prompts()mcp.resource(uri_template, schema, handler)mcp.remove_resource(uri_template)mcp.list_resource_templates()mcp.read_resource(uri, context)mcp.count_resources()mcp.proxy(url, opts)mcp.remove_proxy(url)mcp.begin_batch()mcp.end_batch()mcp.reset(source)MCP tools are constructed per session from plugin scope:
Tools outside the resolved plugin set should not exist for that session.
docs/lua/primitives.md — mcp API and MCP server config.docs/specs/device-hub-spawn-targets.md — session plugin scoping model.cli/lua/lib/mcp.lua — canonical registry implementation.npx claudepluginhub tonksthebear/trybotster --plugin botsterGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.