QWED MCP troubleshooting

​

Installation issues

​

”qwed-mcp: command not found”

1. Install globally:
   pip install qwed-mcp
   
2. Check installation:
   pip show qwed-mcp
   python -m qwed_mcp.server
   
3. Use full path in config:
   {
     "mcpServers": {
       "qwed-verification": {
         "command": "python",
         "args": ["-m", "qwed_mcp.server"]
       }
     }
   }
   

​

“ModuleNotFoundError: No module named ‘sympy’”

pip install qwed-mcp[all]
# or manually:
pip install sympy z3-solver qwed-legal qwed-finance qwed-ucp

​

Claude Desktop issues

​

Server not appearing in Claude

1. Config file location:
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
2. Valid JSON:
   python -c "import json; json.load(open('path/to/config.json'))"
   
3. Restart Claude Desktop (completely quit and reopen)

​

“Failed to start MCP server”

1. Test manually:
   qwed-mcp
   # Should start without errors
   # Press Ctrl+C to exit
   
2. Check logs:
   # Windows
   type %APPDATA%\Claude\logs\mcp*.log
   # macOS
   cat ~/Library/Logs/Claude/mcp*.log
   
3. Enable debug logging:
   {
     "mcpServers": {
       "qwed-verification": {
         "command": "qwed-mcp",
         "env": {
           "QWED_LOG_LEVEL": "DEBUG",
           "QWED_MCP_TRUSTED_CODE_EXECUTION": "true"
         }
       }
     }
   }
   

​

Tool errors

​

”Code execution is disabled”

{
  "mcpServers": {
    "qwed-verification": {
      "command": "qwed-mcp",
      "env": {
        "QWED_MCP_TRUSTED_CODE_EXECUTION": "true"
      }
    }
  }
}

QWED_MCP_TRUSTED_CODE_EXECUTION=true qwed-mcp

​

“BLOCKED: Unknown MCP tool” (or verify_* tools)

BLOCKED: Unknown MCP tool 'verify_math' is blocked by default. (verification_id=...)

​

”Execution timed out after 30 seconds”

1. Increase timeout:
   QWED_TIMEOUT=60 qwed-mcp
   
2. Optimize the script:
   • Break complex computations into smaller steps
   • Avoid infinite loops or very large data processing

​

ModuleNotFoundError in script output

# For legal verification
pip install qwed-legal

# For finance verification
pip install qwed-finance

# For commerce verification
pip install qwed-ucp

# For core engines (math, logic, code, SQL)
pip install qwed-new

​

Migration issues (v0.1.x to v0.2.0)

​

Claude keeps trying to call verify_math

1. Start a new conversation
2. Explicitly tell Claude: “Use execute_python_code instead of verify_math. Write a Python script that imports sympy to verify the calculation.”

​

Scripts fail with import errors

pip install qwed-mcp[all]

​

Getting help

1. GitHub Issues: github.com/QWED-AI/qwed-mcp/issues
2. Documentation: docs.qwedai.com/mcp
3. MCP Protocol Docs: modelcontextprotocol.io