Koskamo

KlearFlow Relay MCP

KlearFlow Relay is a machine-paid x402 service for revenue intelligence, revenue recovery, and paid service routing. It allows agents to inspect revenue opportunities, route tasks to verified providers, and recover lost revenue from missed calls or stale leads using Base USDC payments.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

KlearFlow Relay MCP logo, by erickmckeeCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-07Published by erickmckee
MCP endpoint (Streamable HTTP)
https://klearflow.vercel.app/mcp
Vendor documentation

What its tools do

3 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (3)

3 of 3 have a description · 3 of 3 declare behavior hints · 3 of 3 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Estimate missed-call revenue leakage for local services
  • Find a paid API or machine service for a plain-English task
  • Recover a stale lead or follow up an unanswered quote
  • Reschedule an appointment no-show or recover a failed payment

Source and maintenance

Community listingRegistry 1.0.2
mcp-registry: io.github.erickmckee/klearflow-relay@1.0.2Source repository
Maintenance checked

Protocol and capabilities

Server
klearflow-relay 0.3.2
MCP protocol negotiated in check
2025-11-25
Tools
3 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {}
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Discover KlearFlow tools for free. Start with inspect_revenue_opportunity to quantify leakage, use recover_revenue after a specific loss event, and use route_task to rank external x402 providers. Paid execution uses x402 Base USDC; current prices are exposed by /api/pricing.

Tools

3 advertised

inspect_revenue_opportunity — Inspect Revenue Opportunity
Advertised by the server during the last successful anonymous check.
Advertised read-only

Use this first when deciding whether a business has recoverable missed-call or follow-up revenue leakage. Returns a score, estimated monthly leak, recoverable revenue, and next action. Execution costs $0.005 via x402 Base USDC.

inspect_revenue_opportunity input schema
{
  "type": "object",
  "required": [
    "industry",
    "missedCallsPerWeek",
    "followUpMethod"
  ],
  "properties": {
    "zipCode": {
      "type": "string",
      "description": "Optional postal code used as business-market context."
    },
    "industry": {
      "type": "string",
      "description": "Business industry or service category, for example HVAC, roofing, plumbing, legal, or dental."
    },
    "businessName": {
      "type": "string",
      "description": "Optional business name used only to label the result."
    },
    "interestLevel": {
      "enum": [
        "just_curious",
        "medium",
        "high",
        "urgent"
      ],
      "type": "string",
      "description": "Optional buying/response urgency used to calibrate the recommended commercial action."
    },
    "followUpMethod": {
      "enum": [
        "none",
        "manual",
        "email",
        "text"
      ],
      "type": "string",
      "description": "Current follow-up process for missed opportunities: none, manual human follow-up, email, or text/SMS."
    },
    "averageJobValue": {
      "type": "number",
      "minimum": 0,
      "description": "Average revenue in USD from one won job or customer opportunity."
    },
    "missedCallsPerWeek": {
      "type": "number",
      "minimum": 0,
      "description": "Estimated inbound calls missed per week. Use 0 when none are missed."
    },
    "estimatedRecoveryRate": {
      "type": "number",
      "maximum": 1,
      "minimum": 0,
      "description": "Expected fraction of leaked opportunities that can be recovered, from 0 to 1. Omit to use the model default."
    }
  },
  "additionalProperties": false
}
inspect_revenue_opportunity output schema
{
  "type": "object",
  "required": [
    "proofId",
    "priceUsd",
    "payment",
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "description": "Inspection result containing the leakage score, modeled monthly leak, recoverable revenue estimate, and recommended next action.",
      "additionalProperties": true
    },
    "payment": {
      "type": "object",
      "required": [
        "protocol",
        "payer",
        "transaction",
        "network"
      ],
      "properties": {
        "payer": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Settled payer address when supplied by the payment facilitator."
        },
        "network": {
          "type": "string",
          "description": "Payment network identifier, currently Base mainnet eip155:8453."
        },
        "protocol": {
          "type": "string",
          "const": "x402"
        },
        "transaction": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Settlement transaction identifier when available."
        }
      },
      "additionalProperties": false
    },
    "proofId": {
      "type": "string",
      "description": "Unique KlearFlow proof identifier for this settled paid execution."
    },
    "priceUsd": {
      "type": "number",
      "minimum": 0,
      "description": "USDC-denominated execution price settled through x402."
    }
  },
  "additionalProperties": false
}
inspect_revenue_opportunity annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
route_task — Route Task
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Use this when the caller needs to discover and rank live x402 providers for a task before choosing downstream spend. KlearFlow does not execute the selected provider. Routing costs $0.005 via x402 Base USDC.

route_task input schema
{
  "type": "object",
  "required": [
    "task"
  ],
  "properties": {
    "task": {
      "type": "string",
      "maxLength": 500,
      "minLength": 3,
      "description": "Plain-English capability the caller wants a live x402 provider to perform."
    },
    "limit": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "Maximum number of ranked provider candidates to return."
    },
    "maxPriceUsd": {
      "type": "number",
      "maximum": 1000,
      "minimum": 0,
      "description": "Optional maximum listed provider price in USD."
    },
    "excludeHosts": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 255,
        "minLength": 1
      },
      "maxItems": 20,
      "description": "Optional provider hostnames to exclude from the ranked result, useful to avoid self-routing or previously rejected providers."
    },
    "preferPaidVerified": {
      "type": "boolean",
      "description": "When true, rank providers with independent paid-verification evidence higher."
    }
  },
  "additionalProperties": false
}
route_task output schema
{
  "type": "object",
  "required": [
    "proofId",
    "priceUsd",
    "payment",
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "description": "Routing result containing the ranked live x402 provider candidates and the selected recommendation; no downstream provider is executed.",
      "additionalProperties": true
    },
    "payment": {
      "type": "object",
      "required": [
        "protocol",
        "payer",
        "transaction",
        "network"
      ],
      "properties": {
        "payer": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Settled payer address when supplied by the payment facilitator."
        },
        "network": {
          "type": "string",
          "description": "Payment network identifier, currently Base mainnet eip155:8453."
        },
        "protocol": {
          "type": "string",
          "const": "x402"
        },
        "transaction": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Settlement transaction identifier when available."
        }
      },
      "additionalProperties": false
    },
    "proofId": {
      "type": "string",
      "description": "Unique KlearFlow proof identifier for this settled paid execution."
    },
    "priceUsd": {
      "type": "number",
      "minimum": 0,
      "description": "USDC-denominated execution price settled through x402."
    }
  },
  "additionalProperties": false
}
route_task annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
recover_revenue — Recover Revenue
Advertised by the server during the last successful anonymous check.
Advertised read-only

Use this after a specific revenue-loss event already happened and the caller needs the next recovery action. Returns a prioritized decision packet; KlearFlow sends no external message. Execution costs $0.05 via x402 Base USDC.

recover_revenue input schema
{
  "type": "object",
  "required": [
    "eventType",
    "minutesSinceEvent"
  ],
  "properties": {
    "industry": {
      "type": "string",
      "description": "Optional business industry or service category used to tailor the recovery action."
    },
    "eventType": {
      "enum": [
        "missed_call",
        "stale_lead",
        "quote_unanswered",
        "appointment_no_show",
        "payment_failed"
      ],
      "type": "string",
      "description": "Specific revenue-loss event to recover: missed call, stale lead, unanswered quote, appointment no-show, or failed payment."
    },
    "bookingUrl": {
      "type": "string",
      "description": "Optional booking URL to include in a recommended recovery message."
    },
    "paymentUrl": {
      "type": "string",
      "description": "Optional secure payment-retry URL for payment_failed events."
    },
    "businessName": {
      "type": "string",
      "description": "Optional business name used to label the recovery packet."
    },
    "priorAttempts": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of prior recovery outreach attempts already made."
    },
    "preferredChannel": {
      "enum": [
        "auto",
        "sms",
        "email",
        "phone_task"
      ],
      "type": "string",
      "description": "Preferred recovery channel. Use auto to let KlearFlow select among SMS, email, or a human phone task."
    },
    "customerFirstName": {
      "type": "string",
      "description": "Optional customer first name used only when composing the recommended action text."
    },
    "minutesSinceEvent": {
      "type": "number",
      "minimum": 0,
      "description": "Minutes elapsed since the revenue-loss event occurred."
    },
    "averageOpportunityValue": {
      "type": "number",
      "minimum": 0,
      "description": "Estimated gross value in USD of the customer opportunity."
    }
  },
  "additionalProperties": false
}
recover_revenue output schema
{
  "type": "object",
  "required": [
    "proofId",
    "priceUsd",
    "payment",
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "description": "Recovery decision packet containing priority, recommended action, fallbacks, stop conditions, modeled economics, and safety boundaries.",
      "additionalProperties": true
    },
    "payment": {
      "type": "object",
      "required": [
        "protocol",
        "payer",
        "transaction",
        "network"
      ],
      "properties": {
        "payer": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Settled payer address when supplied by the payment facilitator."
        },
        "network": {
          "type": "string",
          "description": "Payment network identifier, currently Base mainnet eip155:8453."
        },
        "protocol": {
          "type": "string",
          "const": "x402"
        },
        "transaction": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Settlement transaction identifier when available."
        }
      },
      "additionalProperties": false
    },
    "proofId": {
      "type": "string",
      "description": "Unique KlearFlow proof identifier for this settled paid execution."
    },
    "priceUsd": {
      "type": "number",
      "minimum": 0,
      "description": "USDC-denominated execution price settled through x402."
    }
  },
  "additionalProperties": false
}
recover_revenue annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
526 ms
95th percentile latency
526 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 526 ms · metadata changed · 3 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http klearflow-relay-mcp https://klearflow.vercel.app/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add klearflow-relay-mcp --url https://klearflow.vercel.app/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable klearflow-relay-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "klearflow-relay-mcp": {
      "url": "https://klearflow.vercel.app/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "klearflow-relay-mcp": {
      "type": "streamableHttp",
      "url": "https://klearflow.vercel.app/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start klearflow-relay-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "klearflow-relay-mcp": {
      "type": "http",
      "url": "https://klearflow.vercel.app/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http klearflow-relay-mcp https://klearflow.vercel.app/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://klearflow.vercel.app/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "klearflow-relay-mcp": {
      "serverUrl": "https://klearflow.vercel.app/mcp"
    }
  }
}

Let your agent find its tools

Find servers like KlearFlow Relay MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 5,151