diff --git a/docs/CLAUDE.md b/docs/CLAUDE.md
index 16a7e69..5b1cb58 100644
--- a/docs/CLAUDE.md
+++ b/docs/CLAUDE.md
@@ -94,7 +94,7 @@ The LOCAL enhancement option (`--enhance-local` or `enhance_skill_local.py`) ope
 "Package skill at output/react/"
 ```
 
-8 MCP tools available: list_configs, generate_config, validate_config, estimate_pages, scrape_docs, package_skill, split_config, generate_router
+9 MCP tools available: list_configs, generate_config, validate_config, estimate_pages, scrape_docs, package_skill, upload_skill, split_config, generate_router
 
 ### Test with limited pages (edit config first)
 Set `"max_pages": 20` in the config file to test with fewer pages.
@@ -134,7 +134,7 @@ Skill_Seekers/
 │   ├── package_skill.py       # Single skill packager
 │   └── package_multi.py       # Multi-skill packager (NEW)
 ├── mcp/                        # MCP server
-│   ├── server.py              # 8 MCP tools (includes split/router)
+│   ├── server.py              # 9 MCP tools (includes upload)
 │   └── README.md
 ├── configs/                    # Preset configurations
 │   ├── godot.json
diff --git a/docs/MCP_SETUP.md b/docs/MCP_SETUP.md
index 1aca826..68dc176 100644
--- a/docs/MCP_SETUP.md
+++ b/docs/MCP_SETUP.md
@@ -2,10 +2,10 @@
 
 Step-by-step guide to set up the Skill Seeker MCP server with Claude Code.
 
-**✅ Fully Tested and Working**: All 8 MCP tools verified in production use with Claude Code
-- ✅ 31 comprehensive unit tests (100% pass rate)
+**✅ Fully Tested and Working**: All 9 MCP tools verified in production use with Claude Code
+- ✅ 34 comprehensive unit tests (100% pass rate)
 - ✅ Integration tested via actual Claude Code MCP protocol
-- ✅ All 8 tools working with natural language commands (includes large docs support!)
+- ✅ All 9 tools working with natural language commands (includes upload support!)
 
 ---
 
@@ -182,13 +182,16 @@ In Claude Code, type:
 List all available MCP tools
 ```
 
-You should see 6 Skill Seeker tools:
+You should see 9 Skill Seeker tools:
 - `generate_config`
 - `estimate_pages`
 - `scrape_docs`
 - `package_skill`
+- `upload_skill`
 - `list_configs`
 - `validate_config`
+- `split_config`
+- `generate_router`
 
 ### Step 2: Test a Simple Command
 
diff --git a/mcp/README.md b/mcp/README.md
index 5abdacc..a330142 100644
--- a/mcp/README.md
+++ b/mcp/README.md
@@ -72,7 +72,7 @@ You should see a list of preset configurations (Godot, React, Vue, etc.).
 
 ## Available Tools
 
-The MCP server exposes 8 tools:
+The MCP server exposes 9 tools:
 
 ### 1. `generate_config`
 Create a new configuration file for any documentation website.
@@ -116,17 +116,29 @@ Scrape docs using configs/react.json
 ```
 
 ### 4. `package_skill`
-Package a skill directory into a `.zip` file ready for Claude upload.
+Package a skill directory into a `.zip` file ready for Claude upload. Automatically uploads if ANTHROPIC_API_KEY is set.
 
 **Parameters:**
 - `skill_dir` (required): Path to skill directory (e.g., "output/react/")
+- `auto_upload` (optional): Try to upload automatically if API key is available (default: true)
 
 **Example:**
 ```
 Package skill at output/react/
 ```
 
-### 5. `list_configs`
+### 5. `upload_skill`
+Upload a skill .zip file to Claude automatically (requires ANTHROPIC_API_KEY).
+
+**Parameters:**
+- `skill_zip` (required): Path to skill .zip file (e.g., "output/react.zip")
+
+**Example:**
+```
+Upload output/react.zip using upload_skill
+```
+
+### 6. `list_configs`
 List all available preset configurations.
 
 **Parameters:** None
@@ -136,7 +148,7 @@ List all available preset configurations.
 List all available configs
 ```
 
-### 6. `validate_config`
+### 7. `validate_config`
 Validate a config file for errors.
 
 **Parameters:**
@@ -147,7 +159,7 @@ Validate a config file for errors.
 Validate configs/godot.json
 ```
 
-### 7. `split_config` (NEW)
+### 8. `split_config`
 Split large documentation config into multiple focused skills. For 10K+ page documentation.
 
 **Parameters:**
@@ -167,7 +179,7 @@ Split configs/godot.json using router strategy with 5000 pages per skill
 - **router** - Create router/hub skill + specialized sub-skills (RECOMMENDED for 10K+ pages)
 - **size** - Split every N pages (for docs without clear categories)
 
-### 8. `generate_router` (NEW)
+### 9. `generate_router`
 Generate router/hub skill for split documentation. Creates intelligent routing to sub-skills.
 
 **Parameters:**
@@ -347,15 +359,16 @@ python3 -m pytest tests/test_mcp_server.py -v
 - **generate_config** (3 tests)
 - **estimate_pages** (3 tests)
 - **scrape_docs** (4 tests)
-- **package_skill** (2 tests)
+- **package_skill** (3 tests)
+- **upload_skill** (2 tests)
 - **list_configs** (3 tests)
 - **validate_config** (3 tests)
-- **split_config** (3 tests) - NEW
-- **generate_router** (3 tests) - NEW
+- **split_config** (3 tests)
+- **generate_router** (3 tests)
 - **Tool routing** (2 tests)
 - **Integration** (1 test)
 
-**Total: 31 tests | Pass rate: 100%**
+**Total: 34 tests | Pass rate: 100%**
 
 ## Troubleshooting