DealSurface OpenClaw Plugin

OpenClaw plugin for DealSurface that auto-bridges the published MCP package (@dealsurface/mcp-server) and exposes the same 7 tools inside OpenClaw.

This package also ships a progressive-disclosure skill set for GTM teams:

• finding-ranked-prospects
• researching-proof-of-need
• planning-deal-strategy
• finding-leads-and-drafting-outreach

Quick setup

1. Install the plugin on the machine where OpenClaw runs.

   npm install @dealsurface/openclaw-plugin

2. Sign in to DealSurface and create an API key.

   See the API key setup docs for where to create keys, scope guidance, and key rotation details: https://dealsurface.com/docs/api/authentication#api-keys

3. Add the key via OpenClaw config.

   openclaw config set plugins.entries.openclaw-plugin.enabled true
   openclaw config set plugins.entries.openclaw-plugin.config.apiKey "ds_live_your_api_key_here"

   This uses the normalized openclaw-plugin entry key, which the plugin supports directly.

   If you prefer editing the config file manually, use:

   {
     "plugins": {
       "entries": {
         "@dealsurface/openclaw-plugin": {
           "enabled": true,
           "config": {
             "apiKey": "ds_live_your_api_key_here",
             "apiUrl": "https://dealsurface.com",
             "mcpServerId": "dealsurface-mcp"
           }
         }
       }
     }
   }

   OpenClaw may normalize scoped package IDs to unscoped IDs in plugins.entries. If that happens in your install, use openclaw-plugin as the key instead of @dealsurface/openclaw-plugin.

4. Restart OpenClaw so it reloads plugins and starts the DealSurface MCP bridge.

5. Verify the plugin loaded by asking OpenClaw to "list my DealSurface products".

What the plugin does

• Starts a local MCP client bridge to the installed @dealsurface/mcp-server dependency
• Injects DEALSURFACE_API_KEY and optional DEALSURFACE_API_URL
• Registers each DealSurface MCP tool into OpenClaw once (idempotent startup)
• Loads bundled DealSurface GTM skills from skills/

No tool business logic is duplicated in this package. Tool behavior, billing semantics, and parameter contracts come from the MCP server, and the bridged MCP version is pinned by this package release.

Tool surface (bridged from MCP)

• list_products
• get_product
• list_prospects
• get_prospect
• search_excerpts
• get_dealmap
• generate_dealmap
• override_stakeholder_role
• craft_outreach

Troubleshooting

Missing API key

If startup fails with an API key error, set:

• plugins.entries["@dealsurface/openclaw-plugin"].config.apiKey
• or plugins.entries["openclaw-plugin"].config.apiKey

Scope errors

Use an API key with:

• read scope for read tools
• outreach scope for generate_dealmap, override_stakeholder_role, and craft_outreach

Requirements

• Node.js 18+
• OpenClaw 2026.1+
• DealSurface API key

License

This package is proprietary commercial software and is not open source. Use is limited to authorized DealSurface customers and other users expressly approved by DealSurface, and is governed by the applicable DealSurface customer agreement, API terms, or Terms of Service: https://dealsurface.com/terms.

The package and related services are provided "as is" and without warranties or guarantees. See LICENSE for details.