PaidHandshake Exchange MCP

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "feeds": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "quality_hold_count": {
            "type": "integer"
          },
          "paid_eligible_count": {
            "type": "integer"
          }
        }
      }
    },
    "snapshot_id": {
      "type": "string"
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "product"
  ],
  "properties": {
    "product": {
      "enum": [
        "commercial-project-signals",
        "mobile-vendor-opportunities",
        "artist-opportunities",
        "local-demand-signals",
        "research-partnership-opportunities",
        "verified-field-work",
        "buyer-signal-intelligence"
      ],
      "type": "string",
      "description": "Exact published-intelligence product key from get_published_intelligence_catalog. Select the product whose representative paid-eligible sample you want to inspect."
    }
  }
}

{
  "type": "object",
  "required": [
    "feed"
  ],
  "properties": {
    "feed": {
      "enum": [
        "rfp-procurement",
        "business-buyer-intent",
        "vendor-product-pricing",
        "local-service-availability",
        "grants-funding",
        "business-expansion-permits",
        "jobs-contract-work"
      ],
      "type": "string",
      "description": "PaidHandshake feed slug"
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 600,
      "minLength": 3,
      "description": "Natural-language discovery request, 3-600 characters. Include meaningful constraints such as location, timing, budget, product/service type, opportunity type, or other criteria needed to rank relevant current results."
    }
  }
}

{
  "type": "object",
  "required": [
    "search_id"
  ],
  "properties": {
    "search_id": {
      "type": "string",
      "description": "Reusable PaidHandshake search identifier returned by search_matches. Pass the exact search_id whose currently available result-unlock packages and prices you want to inspect."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "search_id",
    "package"
  ],
  "properties": {
    "package": {
      "enum": [
        "single",
        "top3",
        "full"
      ],
      "type": "string",
      "description": "Result package to purchase: single unlocks one selected result, top3 unlocks the next three ranked results, and full unlocks the full available result pack."
    },
    "result_id": {
      "type": "integer",
      "description": "Required only when package=single. Use the result identifier from the locked preview returned by search_matches."
    },
    "search_id": {
      "type": "string",
      "description": "Reusable search identifier returned by search_matches for the result set being purchased."
    }
  }
}

{
  "type": "object",
  "required": [
    "task_type"
  ],
  "properties": {
    "task_type": {
      "type": "string",
      "description": "Requested work category or intent label, such as event_search, bid_search, vendor_search, grant_search, deep_research, or another descriptive task label."
    },
    "constraints": {
      "type": "object",
      "description": "Optional task-specific requirements such as location, date range, maximum results, verification requirements, exclusions, budget, or other execution constraints used to estimate the job."
    }
  }
}

{
  "type": "object",
  "properties": {}
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "required": [
    "query",
    "max_price_cents"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 1200,
      "minLength": 3,
      "description": "Natural-language task to execute. Include the desired outcome and important location, timing, scope, evidence, filtering or result requirements."
    },
    "task_type": {
      "type": "string",
      "description": "Optional routing label describing the work category or intent. Use a descriptive capability label when known; otherwise PaidHandshake can route compatible work from the request."
    },
    "constraints": {
      "type": "object",
      "description": "Optional structured task requirements such as location, date range, maximum results, verification requirements, exclusions, budget or other execution limits."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Optional caller-generated stable key for the same intended paid submission. Reuse the same key when retrying an uncertain request so an accidental duplicate job can be avoided."
    },
    "max_price_cents": {
      "type": "integer",
      "minimum": 1,
      "description": "Maximum amount in USD cents this machine authorizes for this single job. The request remains subject to delegated wallet, per-call, daily, monthly and platform spending limits."
    }
  }
}

{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "PaidHandshake job identifier returned by submit_paid_machine_job. Pass the exact job_id for the authenticated machine account whose status or completed result you want to retrieve."
    }
  }
}

{
  "type": "object",
  "required": [
    "query",
    "max_price_cents"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Optional human-readable label for the watch."
    },
    "query": {
      "type": "string",
      "description": "The recurring research or monitoring request to execute on each scheduled run."
    },
    "task_type": {
      "type": "string",
      "description": "Optional execution category used to route each run to a compatible worker; omit when the query itself is sufficient for routing."
    },
    "constraints": {
      "type": "object",
      "description": "Optional reusable execution constraints applied to every run, such as location, filters, maximum results, verification requirements, or exclusions."
    },
    "cadence_minutes": {
      "type": "integer",
      "maximum": 10080,
      "minimum": 60,
      "description": "Minutes between scheduled runs. Minimum 60 minutes; maximum 10080 minutes (7 days)."
    },
    "max_price_cents": {
      "type": "integer",
      "minimum": 1,
      "description": "Maximum price in USD cents allowed for each individual run before the job is rejected rather than overspending."
    },
    "run_immediately": {
      "type": "boolean",
      "description": "If true, request an initial run immediately after watch creation; if false or omitted, wait for the normal cadence."
    }
  }
}

{
  "type": "object",
  "properties": {}
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "watch_id",
    "enabled"
  ],
  "properties": {
    "enabled": {
      "type": "boolean",
      "description": "true enables future scheduled executions; false disables future scheduled executions for this watch."
    },
    "watch_id": {
      "type": "string",
      "description": "Existing recurring watch identifier, typically returned by create_recurring_paid_watch or list_recurring_paid_watches."
    }
  }
}

{
  "type": "object",
  "properties": {}
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}