Revert Usage section

Author: Michael Brunner

docs/mcp.md

@@ -10,33 +10,41 @@ hide:
 
 ## What is MCP?
 
-The **Model Context Protocol (MCP)** is an open standard that enables AI assistants to securely connect to external context. Think of it as a bridge that allows AI models to access real-time, specialized information beyond their training data.
+The **Model Context Protocol (MCP)** is an open standard that enables AI assistants to securely connect to external
+context. Think of it as a bridge that allows AI models to access real-time, specialized information beyond their
+training data.
 
-When you connect an AI assistant to an MCP server, it gains the ability to query that server for relevant context, making responses more accurate and up-to-date.
+When you connect an AI assistant to an MCP server, it gains the ability to query that server for relevant context,
+making responses more accurate and up-to-date.
 
 ## How MCP helps you learn and use the Cadwork Python API
 
-The Cadwork Python API documentation is available as an MCP server, which transforms how you can learn and work with the API:
-
-- **Contextual Answers**: Ask questions in natural language and get responses that reference the actual API documentation, including function signatures, parameters, and code examples.
-- **Code Generation**: Request script snippets for specific tasks. The AI can generate code using the correct Cadwork API functions because it has direct access to the documentation.
-- **Discovery**: Explore available modules and functions by simply asking "What functions are available for geometry operations?" or "How do I work with elements?"
-- **Troubleshooting**: Describe an error or unexpected behavior, and get help that's grounded in the actual API specifications.
+The Cadwork Python API documentation is available as an MCP server, which transforms how you can learn and work with the
+API:
 
+- **Contextual Answers**: Ask questions in natural language and get responses that reference the actual API
+  documentation, including function signatures, parameters, and code examples.
+- **Code Generation**: Request script snippets for specific tasks. The AI can generate code using the correct Cadwork
+  API functions because it has direct access to the documentation.
+- **Discovery**: Explore available modules and functions by simply asking "What functions are available for geometry
+  operations?" or "How do I work with elements?"
+- **Troubleshooting**: Describe an error or unexpected behavior, and get help that's grounded in the actual API
+  specifications.
 
 ## Setup instructions
 
-To use the Cadwork Python API documentation as an MCP server, you need to configure your AI assistant to connect to it. Here are the most common ai code assistants and how to configure them:
+To use the Cadwork Python API documentation as an MCP server, you need to configure your AI assistant to connect to it.
+Here are the most common ai code assistants and how to configure them:
 
 ??? note "Claude Desktop"
-    Add the following to your Claude Desktop configuration file via the UI:
+Add the following to your Claude Desktop configuration file via the UI:
 
     `Settings` > `Connectors` > `Add custom connectors`
 
     [Claude MCP Documentation](https://modelcontextprotocol.io/docs/develop/connect-remote-servers){target=_blank}
 
 ??? note "Claude Code (CLI)"
-    Claude Code supports MCP servers natively. Add the server using:
+Claude Code supports MCP servers natively. Add the server using:
 
     ```bash
     claude mcp add --transport http cadwork-pyapi https://pyapi.mcp.cadwork.dev/mcp
@@ -45,7 +53,8 @@ To use the Cadwork Python API documentation as an MCP server, you need to config
     [Claude Code MCP Guide](https://docs.anthropic.com/en/docs/claude-code/mcp){target=_blank}
 
 ??? note "ChatGPT"
-    ChatGPT does support MCP servers connector (they are called App) but only on *developer mode*. You need to activate it first and then:
+ChatGPT does support MCP servers connector (they are called App) but only on *developer mode*. You need to activate it
+first and then:
 
     `Settings` > `Apps` > `Create app` (Developer mode: on) > `Create app`
 
@@ -56,7 +65,7 @@ To use the Cadwork Python API documentation as an MCP server, you need to config
     [OpenAI Plugins Documentation](https://help.openai.com/en/articles/11487775-apps-in-chatgpt#building-your-own-app){target=_blank}
 
 ??? note "VS Code (GitHub Copilot)"
-    Add the following to your VS Code settings file (`.vscode/mcp.json` in your workspace or user settings):
+Add the following to your VS Code settings file (`.vscode/mcp.json` in your workspace or user settings):
 
     ```json
     {
@@ -72,8 +81,8 @@ To use the Cadwork Python API documentation as an MCP server, you need to config
     [VS Code MCP Documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers){target=_blank}
 
 ??? note "Gemini CLI"
-    Gemini CLI supports MCP servers natively through its command-line interface. 
-    
+Gemini CLI supports MCP servers natively through its command-line interface.
+
     **Prerequisites**: Install the Gemini CLI first:
 
     ```bash
@@ -99,3 +108,8 @@ To use the Cadwork Python API documentation as an MCP server, you need to config
     </figure>
 
     [Gemini MCP Guide](https://geminicli.com/docs/tools/mcp-server){target=_blank}
+
+## Usage
+
+Once configured, prompt your request to your AI coding assistant and it will automatically query the Cadwork Python API
+documentation to help you write grounded scripts to our Cadwork Python API.