CTP MCP Server
Used in examples for tool generation, such as converting Markdown text to HTML.
Generates production-ready TypeScript tool definitions, implementations, and test suites following the CTP specification with full type safety.
Used in examples for tool generation, such as converting YAML to JSON format.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@CTP MCP Server create a tool that converts CSV files to JSON format"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
CTP MCP Server
MCP server for AI-powered CTP tool generation - describe a tool, get production-ready code.
Overview
The CTP MCP Server is a Model Context Protocol server that helps developers create ConveniencePro Tool Protocol (CTP) tools quickly and easily. Simply describe what tool you want to build, and the MCP server generates complete, production-ready code including:
Tool definitions following the CTP specification
Implementation code (client-side or server-side)
Complete test suites
TypeScript types and validation
Related MCP server: JIT Tool Synthesis
Features
AI-Powered Generation: Describe your tool in natural language
Complete Scaffolding: Get definition, implementation, and tests
CTP Validation: Ensures generated tools follow the specification
Duplicate Detection: Checks for similar existing tools
Template-Based: Consistent, best-practice code generation
Type-Safe: Full TypeScript support
Installation
npm install -g @conveniencepro/ctp-mcp-serverOr use directly with npx:
npx @conveniencepro/ctp-mcp-serverUsage with Claude Desktop
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"ctp-tools": {
"command": "npx",
"args": ["-y", "@conveniencepro/ctp-mcp-server"]
}
}
}Available Tools
ctp_create_tool
Generate a complete CTP tool from a natural language description.
Parameters:
description(required): Natural language description of what the tool should doname(optional): Tool name (auto-generated if not provided)category(optional): Tool categoryexecutionMode(optional): Where the tool runs (client,server, orboth)
Example:
Create a tool that converts YAML to JSONctp_validate_tool
Validate a tool definition against the CTP specification.
Parameters:
definition(required): The tool definition object to validate
ctp_generate_implementation
Generate implementation code from a tool definition.
Parameters:
definition(required): The tool definitionexecutionMode(optional): Execution mode (clientorserver)
ctp_generate_tests
Generate a test suite for a CTP tool.
Parameters:
definition(required): The tool definitionimplementation(optional): The tool implementation code
ctp_search_duplicates
Search for existing tools with similar functionality.
Parameters:
description(required): Description of the tool to search forcategory(optional): Category to narrow search
Example Workflow
Search for duplicates:
Use ctp_search_duplicates to check if a "markdown to HTML converter" already existsGenerate the tool:
Use ctp_create_tool with description: "Convert Markdown text to HTML"Review generated files:
src/tools/markdown-to-html-definition.ts- Tool definitionsrc/tools/markdown-to-html.ts- Implementationsrc/tools/__tests__/markdown-to-html.test.ts- Tests
Implement the logic: Replace the placeholder implementation with actual logic
Test and deploy:
npm test npm run build
Generated Code Structure
// Tool Definition
export const markdownToHtmlDefinition: ToolDefinition = {
id: 'markdown-to-html',
name: 'Markdown to HTML',
description: 'Convert Markdown text to HTML',
category: 'converters',
// ... full specification
};
// Implementation
export const markdownToHtmlFn: ToolFunction<MarkdownToHtmlResult> = (params) => {
// Your implementation here
};
// Tests
describe('Markdown to HTML', () => {
it('should convert markdown to HTML', () => {
// Generated tests
});
});Development
# Clone the repository
git clone https://github.com/titan-alpha/ctp-mcp-server.git
cd ctp-mcp-server
# Install dependencies
npm install
# Build
npm run build
# Run locally
npm startArchitecture
ctp-mcp-server/
├── src/
│ ├── index.ts # MCP server entry point
│ ├── tools/ # MCP tool implementations
│ │ ├── create-tool.ts # Tool scaffolding
│ │ ├── validate-tool.ts # Validation
│ │ ├── generate-*.ts # Code generators
│ │ └── search-*.ts # Duplicate detection
│ ├── templates/ # Handlebars templates
│ │ ├── tool-definition.hbs
│ │ ├── client-implementation.hbs
│ │ └── test-suite.hbs
│ └── utils/ # Utilities
│ ├── template-engine.ts
│ ├── string-utils.ts
│ └── ai-analyzer.ts
└── dist/ # Compiled outputContributing
Contributions are welcome! Please see the CTP repository for contribution guidelines.
License
MIT
Links
Related Packages
@conveniencepro/ctp-core - Core types and validation
@conveniencepro/ctp-runtime - Execution runtime
@conveniencepro/ctp-sdk - Embeddable SDK
@conveniencepro/ctp-examples - Example tools
Available Tools
5 toolsctp_create_toolB
Generate a complete CTP tool from a natural language description. Creates tool definition, implementation, and tests.
Inputs: description (required), name, category, executionMode.
ctp_generate_implementationB
Generate implementation code from a tool definition
Inputs: definition (required), executionMode.
ctp_generate_testsB
Generate test suite for a CTP tool
Inputs: definition (required), implementation.
ctp_search_duplicatesC
Search for existing tools with similar functionality
Inputs: description (required), category.
ctp_validate_toolB
Validate a tool definition against the CTP specification
Inputs: definition (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct step in the CTP tool generation workflow: full creation, implementation, testing, duplicate search, and validation. There is no overlap in purpose.
All tool names follow a consistent pattern: 'ctp_' prefix followed by verb_noun (e.g., create_tool, generate_implementation). No mixing of styles.
With 5 tools, the server covers the essential stages of tool generation without being bloated. Each tool is necessary and well-scoped.
The tools cover creation, implementation, testing, validation, and duplicate detection. A list or delete tool might be useful but is not critical for the generator's purpose.
Related MCP Connectors
Convert, lint and generate LLM tool schemas for OpenAI, Anthropic, Gemini and MCP
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.
33 tools that make AI write, implement, and verify intent against explicit, testable constraints.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn intelligent tool that automates the setup of new Model Context Protocol (MCP) server projects through a conversational interface. It generates project structures, technical specifications, and context-rich documentation to streamline AI-assisted development in TypeScript or Python.103MIT
- FlicenseCqualityDmaintenanceEnables on-demand generation of TypeScript tools using an LLM with human-in-the-loop approval and safe sandboxed execution. It allows users to create and persist custom functionality through natural language requests.81-
- AlicenseNot gradedqualityBmaintenanceAutomatically generates MCP tools, CLI, and web UI from TypeScript methods, enabling AI agents and chat clients to interact with custom capabilities defined once.252 npm100MIT
- AlicenseNot gradedqualityDmaintenanceGenerates complete, runnable MCP server projects from natural-language tool descriptions, including schema, implementation, tests, README, and license. It enables AI agents to scaffold standalone MCP servers ready to install and run.MIT