Skip to content

Commit e2f15e8

Browse files
committed
fix(docs): correct typos and improve clarity in agentic MCP documentation
1 parent 0d9f7d9 commit e2f15e8

File tree

1 file changed

+33
-9
lines changed

1 file changed

+33
-9
lines changed

docs/quickstart/create-your-first-agentic-mcp.md

Lines changed: 33 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
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.
44
This 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
77
tool?
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
8080
use it, and how to use it. Below is an example of a description of a coding
8181
agent.
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

8989
Advanced 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
100124
using `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
118142
const serverInitOpts = [
119143
{
120144
name: "coding-agent",
@@ -195,7 +219,7 @@ VS Code (supports sampling mode):
195219
Claude 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

201225
Alternatively, to run this agent programmatically, we recommend using the

0 commit comments

Comments
 (0)