11# Create your first agentic MCP
22
3- Normal MCP Servers have tools that excute unit tasks and give feedback to LLM.
3+ Normal MCP Servers have tools that execute unit tasks and give feedback to LLM.
44This provides extra context for the LLM to interact with the outer environment.
55
6- What if we take this a step further by predefing your task in a single agentic
6+ What if we take this a step further by predefining your task in a single agentic
77tool?
88
99** What benefits do you have?**
@@ -80,23 +80,47 @@ Agent documentation is crucial for telling an LLM what the agent does, when to
8080use it, and how to use it. Below is an example of a description of a coding
8181agent.
8282
83- You might be notice the xml-like tool syntax, it's designed for referencing
84- dependant MCP tools inside agent docs, ` <tool> ` tag have following properties:
83+ You might notice the xml-like tool syntax, it's designed for referencing
84+ dependent MCP tools inside agent docs, ` <tool> ` tag has following properties:
8585
86- - name(type string): it defines which tool to select from a dependant MCP
86+ - name(type string): it defines which tool to select from a dependent MCP
8787 server, syntax {mcp_server_name}.{tool_name};
8888
8989Advanced properties:
9090
9191- global(type boolean): default is false, referenced tools are cohesed in mcpc
9292 internal tools, by setting it to true, you can expose them on the MCP tools
9393 scope;
94- - hide(type boolean): default is false, it commonly used when you are overiding
94+ - hide(type boolean): default is false, it commonly used when you are overriding
9595 the tool with custom props or results
9696
97+ ``` typescript
98+ const description = ` You are a "codex fork" agent, a world-class AI assistant for coding tasks.
99+
100+ Workflow:
101+ 1. Project Overview: Use <tool name="lsmcp.get_project_overview"/> to understand the project structure.
102+ 2. Code Discovery: Locate relevant files using <tool name="lsmcp.search_symbols"/>, <tool name="desktop-commander.start_search"/>, or <tool name="desktop-commander.list_directory"/>.
103+ 3. Implementation: Apply changes with <tool name="desktop-commander.edit_block"/> and verify with <tool name="lsmcp.lsp_get_diagnostics"/>.
104+ 4. Build and Commit: Execute build commands with <tool name="desktop-commander.start_process"/>, then commit changes.
105+ 5. Submission: Create pull requests with <tool name="github.create_pull_request"/>.
106+
107+ Available tools:
108+ <tool name="desktop-commander.start_process"/>
109+ <tool name="desktop-commander.read_file"/>
110+ <tool name="desktop-commander.write_file"/>
111+ <tool name="desktop-commander.edit_block"/>
112+ <tool name="desktop-commander.start_search"/>
113+ <tool name="desktop-commander.list_directory"/>
114+ <tool name="lsmcp.get_project_overview"/>
115+ <tool name="lsmcp.search_symbols"/>
116+ <tool name="lsmcp.lsp_get_definitions"/>
117+ <tool name="lsmcp.lsp_get_diagnostics"/>
118+ <tool name="github.create_pull_request"/> ` ;
119+ ```
120+
97121# Start the agentic MCP server
98122
99- Now the denpendent MCPs and agent description are ready, let's start the server
123+ Now the dependent MCPs and agent description are ready, let's start the server
100124using ` mcpc ` function.
101125
102126## Create the MCP server
@@ -114,7 +138,7 @@ You can choose one of two modes for internal tool invocation:
114138 implementation.
115139
116140``` typescript
117- // description and deps are declared from abloe
141+ // description and deps are declared from above
118142const serverInitOpts = [
119143 {
120144 name: " coding-agent" ,
@@ -195,7 +219,7 @@ VS Code (supports sampling mode):
195219Claude Code:
196220
197221``` bash
198- claude mcp add playwright npx tsx server.ts
222+ claude mcp add codex-fork -- npx tsx server.ts
199223```
200224
201225Alternatively, to run this agent programmatically, we recommend using the
0 commit comments