---

name: mcp-client description: Connect OpenClaw to any MCP (Model Context Protocol) server - Swiggy, Zomato, GitHub, and hundreds more! version: 1.0.0 author: Toki (OpenClaw Assistant)

MCP Client Skill

Connect OpenClaw to the entire MCP ecosystem!

What This Skill Does

This skill enables OpenClaw to communicate with any HTTP-based MCP (Model Context Protocol) server, giving you instant access to:

• 🍛 Swiggy - Food ordering, groceries (Instamart), table booking (Dineout)
• 🍕 Zomato - Restaurant discovery and food ordering
• 💻 GitHub - Code, issues, PRs (when configured)
• 💬 Slack - Team communication (when configured)
• 🗄️ Databases - PostgreSQL, MySQL, MongoDB (when configured)
• 🔌 And hundreds more MCP servers!

Installation

cd ~/.openclaw/workspace/skills
git clone https://github.com/ImrKhn03/openclaw-mcp-client.git
cd openclaw-mcp-client
npm install

Configuration

Add MCP Servers

Create JSON config files in the servers/ directory:

{
  "name": "my-server",
  "type": "http",
  "url": "https://mcp.example.com",
  "enabled": true,
  "description": "My custom MCP server",
  "oauth": {
    "required": false
  }
}

Pre-configured servers:

• ✅ Swiggy Food (swiggy-food.json)
• ✅ Swiggy Instamart (swiggy-instamart.json)
• ✅ Zomato (zomato.json)

OAuth Setup (For Swiggy/Zomato)

When a server requires OAuth, the skill will:

1. Print an authorization URL
2. Start a local callback server
3. Wait for you to authorize in your browser
4. Automatically save the token

Usage

Once installed, the skill automatically registers all MCP tools as OpenClaw commands!

Real-World Usage Examples

🛒 Grocery Shopping (Swiggy Instamart)

You: "I need milk and bread from Instamart"

OpenClaw:

1. Searches Instamart for "milk" and "bread"
2. Shows product options with prices
3. Asks which ones you want
4. Adds to cart
5. Shows cart summary
6. Places order on confirmation

Example conversation:

You: Order milk from Instamart

Bot: Found these options:
1. Nandini Toned Milk 500ml - ₹24
2. Amul Gold Milk 500ml - ₹32
3. Mother Dairy Milk 500ml - ₹26

You: The first one

Bot: Added Nandini Toned Milk to cart!
    
    Cart Total: ₹24
    Delivery: FREE (minimum order met)
    
    Place order?

You: Yes

Bot: ✅ Order placed! Order ID: #123456
    ETA: 15 minutes

🍛 Food Ordering (Swiggy)

You: "Find good biryani places"

OpenClaw:

1. Searches Swiggy for biryani restaurants
2. Shows top-rated options nearby
3. Displays menus
4. Helps add items to cart
5. Manages order placement

Example:

You: Order chicken biryani for lunch, budget ₹300

Bot: Found 8 restaurants! Top picks:
1. Paradise Biryani - ₹250 (4.5⭐, 25 min)
2. Meghana Biryani - ₹280 (4.6⭐, 30 min)
3. Empire Restaurant - ₹220 (4.4⭐, 20 min)

You: Meghana looks good

Bot: Meghana Biryani menu:
- Chicken Dum Biryani (full) - ₹280
- Chicken 65 Biryani - ₹300
- Chicken Fry Piece Biryani - ₹290

You: The first one

Bot: Added Chicken Dum Biryani to cart!
    Total: ₹280 + ₹40 delivery = ₹320
    
    Continue to checkout?

🔍 Restaurant Discovery (Zomato)

You: "Show me top Italian restaurants with outdoor seating"

OpenClaw:

1. Searches Zomato with filters
2. Shows restaurants matching criteria
3. Displays reviews, ratings, prices
4. Can book tables (if Dineout integrated)

🛠️ Multi-Server Workflows

You: "Compare biryani prices between Swiggy and Zomato"

OpenClaw:

1. Searches both platforms simultaneously
2. Compares prices, ratings, delivery times
3. Presents side-by-side comparison
4. Lets you choose the best option

Natural Language Commands

The skill understands these patterns:

Food Ordering:

• "Order [food] from [service]"
• "Find [cuisine] restaurants"
• "Show me the menu for [restaurant]"
• "What's good at [restaurant]?"
• "Add [item] to cart"

Groceries:

• "Buy [item] from Instamart"
• "Search for [product]"
• "Add [item] to grocery cart"
• "Check my Instamart cart"
• "Place grocery order"

General:

• "What MCP tools are available?"
• "Check my [service] orders"
• "Track order #[id]"
• "What can you do with MCP?"

Natural Language Examples (Original)

"Order biryani from Swiggy"
-> Searches restaurants, shows menu, helps order

"Find Italian restaurants near me on Zomato"
-> Uses Zomato MCP to search

"Add milk to my Instamart cart"
-> Uses Swiggy Instamart MCP

"What tools are available?"
-> Lists all registered MCP tools

Programmatic Usage

const MCPClient = require('./index');

const client = new MCPClient();
await client.initialize();

// List all tools
const tools = client.getTools();

// Search for specific tools
const foodTools = client.searchTools('restaurant');

// Call a tool
const result = await client.callTool('swiggy-food', 'search_restaurants', {
  location: { lat: 12.9351929, lng: 77.62448069999999 },
  query: 'biryani'
});

How It Works

1. Discovery: Skill loads all JSON configs from servers/
2. Connection: Connects to each enabled MCP server
3. Tool Registration: Fetches available tools from each server
4. Dynamic Integration: Registers tools as OpenClaw commands
5. Execution: Routes tool calls to the appropriate MCP server

Skill Behavior

When you mention food ordering, restaurants, or grocery shopping, the skill:

1. Detects which MCP server is relevant (Swiggy, Zomato, etc.)
2. Checks if OAuth is required
3. Calls the appropriate MCP tool
4. Formats and presents results
5. Helps complete the action (ordering, booking, etc.)

Extending

Add New MCP Servers

Just drop a JSON config in servers/:

{
  "name": "github",
  "type": "http",
  "url": "https://mcp.github.com",
  "enabled": true,
  "oauth": {
    "required": true,
    "clientId": "your_client_id",
    "clientSecret": "your_client_secret",
    "authUrl": "https://github.com/login/oauth/authorize",
    "tokenUrl": "https://github.com/login/oauth/access_token",
    "scopes": ["repo", "user"]
  }
}

Restart OpenClaw and the new server is ready!

Troubleshooting

Connection Issues

# Test connectivity
node index.js

# Should show all discovered tools

OAuth Problems

• Check that redirect URI matches: http://localhost:3000/oauth/callback
• Verify client ID and secret in server config
• Ensure server has whitelisted the redirect URI

Tool Not Found

# List all available tools
node index.js

Architecture

┌─────────────────┐
│   OpenClaw      │
└────────┬────────┘
         │
    ┌────▼─────┐
    │ MCP Skill │ (this skill)
    └────┬─────┘
         │
    ┌────▼──────────┐
    │  MCP Manager  │ Manages multiple servers
    └────┬──────────┘
         │
    ┌────▼──────┬──────────┬─────────┐
    │           │          │         │
┌───▼────┐ ┌───▼────┐ ┌───▼────┐ ┌──▼────┐
│ Swiggy │ │ Zomato │ │ GitHub │ │  ...  │
└────────┘ └────────┘ └────────┘ └───────┘

Troubleshooting

OAuth Not Working

Symptoms:

• Getting 401/403 errors when calling tools
• OAuth wizard completes but tools still fail

Solutions:

1. Check OAuth status: npm run oauth:status
2. Re-run OAuth wizard for the failing server: npm run oauth <server-name>
3. Verify server config has correct OAuth endpoints
4. Check .oauth-tokens.json has a valid token for the server

Tools Not Showing Up

Symptoms:

• npm run list-tools shows no tools or fewer than expected
• Server is enabled but tools missing

Solutions:

1. Check server is enabled in config: "enabled": true
2. Verify server URL is reachable: curl <server-url>/mcp/v1/tools
3. Check for errors in console output when running commands
4. Try disabling and re-enabling the server

Connection Errors

Symptoms:

• ECONNREFUSED, ETIMEDOUT, or network errors
• "Failed to fetch tools" messages

Solutions:

1. Verify server URL is correct (include https://)
2. Check if server requires VPN or specific network access
3. Test server URL in browser or with curl
4. Check if server requires authentication (OAuth setup needed)

"Server Not Found" Errors

Symptoms:

• Error: Server '<name>' not found

Solutions:

1. Check server config file exists in servers/ directory
2. Verify filename matches: <server-name>.json
3. Ensure JSON is valid (no syntax errors)
4. Check server name in config matches what you're calling

OAuth Tokens Expired

Symptoms:

• Tools worked before, now getting auth errors
• "Token expired" or "Invalid token" messages

Solutions:

1. Re-run OAuth wizard: npm run oauth <server-name>
2. Check if server requires token refresh (some expire quickly)
3. Verify .oauth-tokens.json is not corrupted

Installation Issues

Symptoms:

• npm install fails
• Missing dependencies errors

Solutions:

1. Check Node.js version: node -v (need v18+)
2. Clear npm cache: npm cache clean --force
3. Delete node_modules and package-lock.json, then npm install again
4. Check internet connection for package downloads

Common Mistakes

❌ Calling tools before OAuth setup

• Many servers require OAuth. Run npm run oauth:status first

❌ Wrong server name in calls

• Use exact server name from config file (case-sensitive)

❌ Disabled servers

• Check "enabled": true in server config

❌ Missing required parameters

• Each tool has required parameters - check with list-tools for schema

Getting Help

If you're still stuck:

1. Check the logs in console output (look for error messages)
2. Review server config JSON for typos
3. Test the MCP server URL directly with curl
4. Open an issue on GitHub with error details

---

Development

Built by Toki (OpenClaw Assistant) for @ImrKhn03 and the OpenClaw community!

Contributing

PRs welcome! Please:

• Add tests for new features
• Update documentation
• Follow existing code style

License

MIT License - See LICENSE file

Links

• GitHub: https://github.com/ImrKhn03/openclaw-mcp-client
• ClawdHub: (Publishing soon!)
• MCP Spec: https://spec.modelcontextprotocol.io/

---

Built with ❤️ by Toki
Making OpenClaw even more powerful! 🦞