EntRoute

Discover pay-per-request API endpoints for a given capability. Returns ranked, verified endpoints with pricing and reliability metrics. Use this to find APIs before calling them. The results include: - Endpoint URL and method - Price per call and payment network - Success rate and latency metrics - Provider information - sample_request / sample_response: Example request body and response showing the exact parameter names and format the endpoint expects. ALWAYS use sample_request as your template when calling the endpoint — do not guess parameter names. After discovering, you can use call_paid_api to execute the endpoint. Trust & safety: - "Verified" means the endpoint returns a valid x402 402 response -- it does not guarantee the quality or accuracy of the data returned after payment. - Endpoints are probed every 10 minutes. Check last_verified and success_rate to gauge reliability. - Fallback endpoints (unverified) have failed recent verification checks -- use with caution. - Prefer endpoints with success_rate >95% and verification within the last 24 hours.

{
  "type": "object",
  "properties": {
    "intent": {
      "type": "string",
      "description": "Natural language description of what you want to do (e.g., \"get current weather for London\", \"translate text to Spanish\"). Provide this or capability_id."
    },
    "capability_id": {
      "type": "string",
      "description": "Explicit capability ID if known (e.g., \"weather.current\", \"translate.text\"). Alternative to intent for precise matching."
    },
    "max_price": {
      "type": "number",
      "description": "Maximum price per request in USD (e.g., 0.01 for 1 cent)"
    },
    "network": {
      "type": "string",
      "description": "Required blockchain network for payment",
      "enum": [
        "base",
        "ethereum",
        "solana",
        "polygon",
        "arbitrum"
      ]
    },
    "ranking_preset": {
      "type": "string",
      "description": "Ranking preference preset",
      "enum": [
        "default",
        "reliability",
        "speed",
        "budget",
        "balanced"
      ]
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of endpoints to return (default: 5)"
    }
  },
  "required": [
    "intent"
  ]
}

List available API capability types. Use this to explore what kinds of APIs are available in the registry. You can filter by tag (e.g., "weather", "translation") or search by keyword. Note: A capability existing does not mean verified endpoints are available for it. Use discover_paid_api to check for live endpoints.

{
  "type": "object",
  "properties": {
    "tag": {
      "type": "string",
      "description": "Filter by tag (e.g., \"weather\", \"translation\", \"finance\")"
    },
    "search": {
      "type": "string",
      "description": "Search capabilities by keyword"
    }
  }
}

Call a previously discovered API endpoint. Use this after discover_paid_api to execute the request. IMPORTANT: You must first use discover_paid_api to find an endpoint. Then use the endpoint_id from the discovery result. Use the sample_request from the discovery result as your body template — it shows the exact parameter names the endpoint expects. Replace the example values with the actual values you need. Payment: this hosted server holds no wallet, so it cannot settle x402 payments. Free endpoints return their data directly. Paid endpoints return the payment challenge (amount, recipient, network) without charging anything. To pay automatically, run the local server instead: npx @entroute/mcp-server with EVM_PRIVATE_KEY set. Trust & safety: - EntRoute verifies that endpoints return valid 402 responses every 10 minutes, but does not guarantee response quality or accuracy. Treat results like any third-party API. - Prefer endpoints with high success rates (>95%) and recent verification timestamps.

{
  "type": "object",
  "properties": {
    "endpoint_id": {
      "type": "string",
      "description": "The endpoint_id from a previous discover_paid_api result"
    },
    "method": {
      "type": "string",
      "description": "HTTP method (defaults to endpoint method)",
      "enum": [
        "GET",
        "POST",
        "PUT",
        "PATCH",
        "DELETE"
      ]
    },
    "headers": {
      "type": "object",
      "description": "Additional headers to include in the request",
      "additionalProperties": {
        "type": "string"
      }
    },
    "body": {
      "type": "object",
      "description": "Request body (for POST/PUT/PATCH)",
      "additionalProperties": true
    },
    "query_params": {
      "type": "object",
      "description": "Query parameters to append to URL",
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "required": [
    "endpoint_id"
  ]
}