Server definition

Hash: sha256:7833f6f25da9c4a183f36db85a9fd45612e7ffcc911f15338799c68a3feb1dcc
What it is: What a remote MCP server returned when asked what it offers: 18 tools

The blob, as servednamed by its sha256

{
  "instructions": "Unphurl is a domain intelligence API for AI agents. One URL in, structured security and data quality signals out. Use check_url for single URLs, check_urls for batches. Run show_defaults to see scoring signals, or get_pricing for credit packages.",
  "tools": [
    {
      "description": "Add one or more domains to this account's trusted allowlist.\n\nAllowlisted domains suppress the compound signal and brand impersonation floor in scoring. The full pipeline still runs — all signals remain visible so you can monitor trusted domains for SSL expiry, parking, or other changes.\n\nSubmit the registrable domain only (e.g. partnerco.com). Subdomains and full URLs are rejected. Adding partnerco.com covers sub.partnerco.com and all other subdomains automatically.\n\nMaximum 1,000 domains per account. Maximum 100 domains per request. Duplicates are silently skipped.",
      "inputSchema": {
        "properties": {
          "domains": {
            "description": "Registrable domains to add (e.g. ['partnerco.com', 'trustedvendor.io']). Subdomains and full URLs are rejected.",
            "items": {
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 100,
            "minItems": 1,
            "type": "array"
          }
        },
        "required": [
          "domains"
        ],
        "type": "object"
      },
      "name": "add_to_allowlist",
      "outputSchema": null
    },
    {
      "description": "View recent URL check history. Shows what URLs have been checked, their scores, phishing status, and whether each check was free or used a pipeline credit.\n\nResults are paginated. Use page and limit parameters to navigate. Default is 20 results per page, maximum 100.\n\nHistory is retained for 90 days. Account-level stats (total credits, balance) never expire.",
      "inputSchema": {
        "properties": {
          "limit": {
            "description": "Results per page, max 100 (default 20)",
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "page": {
            "description": "Page number (default 1)",
            "minimum": 1,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "check_history",
      "outputSchema": null
    },
    {
      "description": "Check a single URL for security and data quality signals. Returns a risk score (0-100), detailed signal breakdown, and metadata.\n\nUnphurl analyses URLs across seven dimensions: redirect behaviour, brand impersonation, domain intelligence (age, registrar, expiration, status codes, nameservers via RDAP), SSL/TLS validity, parked domain detection, URL structural analysis (length, path depth, subdomain count, entropy), and DNS enrichment (MX records). The score is calculated from these signals using either default weights or a custom scoring profile.\n\nHigher scores mean more suspicious. The score is a signal, not a verdict. You decide the threshold based on the use case.\n\nBilling: Most lookups are free. Known domains (Tranco Top 100K like google.com, github.com) return instantly with score 0 at no cost. Previously analysed domains return cached signals at no cost. Only unknown domains that run through the full analysis pipeline cost 1 pipeline check credit. The response's meta.pipeline_check_charged field tells you whether this check consumed a credit.\n\nUse the \"profile\" parameter to score results with custom weights. For example, a \"cold-email\" profile might weight parked domains heavily while ignoring brand impersonation. Use list_profiles to see available profiles, or show_defaults to see all signal weights.\n\nIf the account has zero credits and the URL requires a full pipeline check, returns a 402 error with a link to purchase more credits.",
      "inputSchema": {
        "properties": {
          "profile": {
            "description": "Name of a custom scoring profile to use (optional). If omitted, default weights are used.",
            "type": "string"
          },
          "url": {
            "description": "The URL to check (must be http:// or https://)",
            "format": "uri",
            "maxLength": 2048,
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "type": "object"
      },
      "name": "check_url",
      "outputSchema": null
    },
    {
      "description": "Check multiple URLs in a single batch. Returns results for all URLs, handling async processing automatically.\n\nEach URL is analysed across seven dimensions: redirect behaviour, brand impersonation, domain intelligence (age, registrar, expiration, status codes, nameservers via RDAP), SSL/TLS validity, parked domain detection, URL structural analysis, and DNS enrichment. Known and cached URLs return results immediately. Unknown URLs are queued for pipeline processing. This tool automatically polls for results until all URLs are complete or the 5-minute timeout is reached. You don't need to manage polling or job tracking.\n\nIf the timeout is reached before all results are complete, returns whatever is available with a clear message indicating which URLs are still processing. The user can check results later via check_history.\n\nMaximum 500 URLs per call. For larger datasets, call this tool multiple times with chunks of up to 500 URLs.\n\nBilling: Same as check_url. Known and cached domains are free. Only unknown domains running through the full pipeline cost 1 credit each. The summary shows pipeline_checks_charged (the actual number of credits consumed). If you don't have enough credits for the unknowns in the batch, the entire batch is rejected with a 402 error telling you exactly how many credits are needed.\n\nDuplicate URLs in the list are automatically deduplicated (processed once, charged once). Invalid URLs get individual error status without rejecting the batch.\n\nUse the \"profile\" parameter to score all results with custom weights.",
      "inputSchema": {
        "properties": {
          "profile": {
            "description": "Name of a custom scoring profile to use for all URLs (optional)",
            "type": "string"
          },
          "urls": {
            "description": "List of URLs to check (maximum 500 per call)",
            "items": {
              "format": "uri",
              "maxLength": 2048,
              "type": "string"
            },
            "maxItems": 500,
            "minItems": 1,
            "type": "array"
          }
        },
        "required": [
          "urls"
        ],
        "type": "object"
      },
      "name": "check_urls",
      "outputSchema": null
    },
    {
      "description": "Create or update a custom scoring profile. Profiles are sparse overrides: only specify the weights you want to change. Everything else keeps its default value.\n\nIf a profile with this name already exists, it is updated with the new weights (full replacement, not merge).\n\nWeights are points, not percentages. Each weight is the number of points that signal adds to the score when it fires. They don't need to total 100. A profile with weights totalling 90 is conservative (max possible score is 90). A profile with weights totalling 130 is aggressive (multiple signals quickly push to the cap of 100). The threshold the agent sets for action matters more than the weight totals.\n\nUse show_defaults to see all 25 signals with their default weights and descriptions before creating a profile. Use check_url or check_urls with the \"profile\" parameter to score results with this profile.\n\nMaximum 20 profiles per account. Profile name \"default\" is reserved.\n\nCommon profiles:\n- Cold email: weight parked (30), chain_incomplete (25), ssl_invalid (15) higher. Lower brand_impersonation (10).\n- Security bot: keep brand_impersonation high (40), increase domain_age_7 (30), redirects_5 (25).\n- Lead gen: weight parked (35), http_only (20), chain_incomplete (20) for dead business detection.\n- SEO audit: weight redirects_5 (30), chain_incomplete (30), parked (25) for link quality.\n\nSee the Unphurl API documentation for all 19 use case weight examples.",
      "inputSchema": {
        "properties": {
          "name": {
            "description": "Profile name (lowercase alphanumeric and hyphens only, 1-50 chars, e.g. 'cold-email', 'security-bot')",
            "pattern": "^[a-z0-9][a-z0-9-]{0,48}[a-z0-9]$|^[a-z0-9]$",
            "type": "string"
          },
          "weights": {
            "additionalProperties": {
              "maximum": 1000,
              "minimum": 0,
              "type": "integer"
            },
            "description": "Custom weights for scoring signals. Only include signals you want to override. Available signals: brand_impersonation (default 40), domain_age_3 (35), domain_age_7 (25), domain_age_30 (15), domain_age_90 (5), ssl_invalid (10), http_only (5), redirects_3 (10), redirects_5 (25), chain_incomplete (15), parked (10), compound (10), brand_impersonation_floor (80), url_long (3), path_deep (3), subdomain_deep (3), subdomain_excessive (5), domain_entropy_high (5), url_contains_ip (10), encoded_hostname (5), tld_redirect_change (5), js_fragment_redirect (25), expiring_soon (10), domain_status_bad (15), no_mx_record (5).",
            "type": "object"
          }
        },
        "required": [
          "name",
          "weights"
        ],
        "type": "object"
      },
      "name": "create_profile",
      "outputSchema": null
    },
    {
      "description": "Delete a custom scoring profile. This is permanent. Any future check requests using this profile name will fall back to default weights.\n\nUse list_profiles to see your current profiles before deleting.",
      "inputSchema": {
        "properties": {
          "name": {
            "description": "Name of the profile to delete",
            "pattern": "^[a-z0-9][a-z0-9-]{0,48}[a-z0-9]$|^[a-z0-9]$",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "name": "delete_profile",
      "outputSchema": null
    },
    {
      "description": "Pre-flight credit estimator for a list of URLs. Returns counts + credit estimate. Free, no credits consumed.\n\nCall this before check_urls to show the user how many credits the batch will cost. Classifies each URL against three free gates:\n- tranco: URL's registrable domain is in the Tranco top 100K (trusted, treated as clean with score 0, no pipeline needed)\n- cached: URL's hostname is already in Unphurl's reputation cache (results available, no pipeline needed)\n- unknown: URL needs full pipeline analysis (costs 1 credit per URL)\n\nReturns counts for each gate plus total, credits_needed, credits_min, and credits_max. credits_min and credits_max are both equal to the unknown count in the current implementation.\n\nMaximum 500 URLs per call. Rate limit: 10 requests per minute. Does not follow redirects; classifies each URL as submitted.\n\nTypical agent flow:\n1. Collect a list of URLs\n2. Call estimate_urls to get the cost breakdown\n3. Show the user the breakdown and ask for approval\n4. On approval, call check_urls on the unknowns only",
      "inputSchema": {
        "properties": {
          "urls": {
            "description": "List of URLs to classify (maximum 500 per call)",
            "items": {
              "format": "uri",
              "maxLength": 2048,
              "type": "string"
            },
            "maxItems": 500,
            "minItems": 1,
            "type": "array"
          }
        },
        "required": [
          "urls"
        ],
        "type": "object"
      },
      "name": "estimate_urls",
      "outputSchema": null
    },
    {
      "description": "Generate a branded PDF audit report. Pass the complete audit JSON object and your reseller details. Returns a 24-hour download link.",
      "inputSchema": {
        "properties": {
          "audit_json": {
            "description": "The complete audit JSON object produced during the audit pipeline.",
            "type": "object"
          },
          "reseller_company_url": {
            "description": "Your company URL (optional).",
            "type": "string"
          },
          "reseller_email": {
            "description": "Your contact email.",
            "type": "string"
          },
          "reseller_name": {
            "description": "Your full name.",
            "type": "string"
          },
          "reseller_position": {
            "description": "Your position or title (optional).",
            "type": "string"
          }
        },
        "required": [
          "audit_json",
          "reseller_name",
          "reseller_email"
        ],
        "type": "object"
      },
      "name": "generate_pdf",
      "outputSchema": null
    },
    {
      "description": "Check your pipeline check credit balance. Shows credits remaining, total purchased, total used, and lifetime free lookups count.\n\nCredits are consumed only when unknown domains run through the full analysis pipeline. Known domains (Tranco Top 100K) and cached domains (previously analysed by any Unphurl customer) are always free.\n\nIf credits_remaining is 0, you can still check known and cached domains for free. To check unknown domains, purchase more credits using the \"purchase\" tool.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "get_balance",
      "outputSchema": null
    },
    {
      "description": "Show available pipeline check credit packages and pricing. Returns all packages with credit counts and prices.\n\nPackages (one-time purchase, no subscription):\n- Starter: 100 credits for $9 ($0.09 each)\n- Standard: 500 credits for $39 ($0.078 each)\n- Pro: 2,000 credits for $99 ($0.0495 each)\n- Scale: 10,000 credits for $399 ($0.0399 each)\n\nMost URL lookups are free (known domains and cached domains). Credits are only consumed when an unknown domain runs through the full analysis pipeline. In typical use, 95-99% of URLs resolve free.\n\nThis tool does not require an API key.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "get_pricing",
      "outputSchema": null
    },
    {
      "description": "View your account usage statistics. Shows total URLs submitted, breakdown by gate (Tranco lookups, cache lookups, pipeline checks), free rate percentage, score threshold counts, and credit balance.\n\nUse this to understand your usage patterns: how many of your checks resolved free (known or cached domains) vs paid pipeline checks, and how many URLs scored above key thresholds.\n\nThis is useful for:\n- Checking if your scoring profile is flagging the right proportion of URLs\n- Understanding your cost efficiency (higher free rate = more value per credit)\n- Reporting usage metrics",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "get_stats",
      "outputSchema": null
    },
    {
      "description": "List all domains on this account's trusted allowlist.\n\nAllowlisted domains suppress the compound signal and brand impersonation floor in scoring. The full pipeline still runs — all signals remain visible for monitoring. Use this to see which domains are currently trusted.\n\nReturns the list of domains, current count, and the 1,000-domain limit.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "list_allowlist",
      "outputSchema": null
    },
    {
      "description": "List all custom scoring profiles on this account. Returns profile names and their custom weight overrides.\n\nProfiles are named weight sets that change how Unphurl scores URLs. Different use cases need different scoring. A cold email agent cares about dead domains. A security bot cares about phishing. Profiles let one account serve multiple use cases.\n\nProfiles only override specific weights. Any signal not specified in a profile uses the default weight. Use show_defaults to see all 25 signals and their default weights.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "list_profiles",
      "outputSchema": null
    },
    {
      "description": "Purchase pipeline check credits. Returns a Stripe Checkout URL that the user must open in a browser to complete payment.\n\nThe AI cannot complete the payment. Tell the user to open the URL in their browser, complete the Stripe checkout, and then confirm they've paid. Credits are added to the account automatically once Stripe confirms payment.\n\nAfter purchase, use get_balance to verify credits have been added.",
      "inputSchema": {
        "properties": {
          "package": {
            "description": "Package to purchase: pkg_100 ($9, 100 credits), pkg_500 ($39, 500 credits), pkg_2000 ($99, 2000 credits), pkg_10000 ($399, 10000 credits)",
            "enum": [
              "pkg_100",
              "pkg_500",
              "pkg_2000",
              "pkg_10000"
            ],
            "type": "string"
          }
        },
        "required": [
          "package"
        ],
        "type": "object"
      },
      "name": "purchase",
      "outputSchema": null
    },
    {
      "description": "Remove one or more domains from this account's trusted allowlist.\n\nOnce removed, those domains resume normal scoring on the next check. Use list_allowlist to see what is currently on the list before removing.",
      "inputSchema": {
        "properties": {
          "domains": {
            "description": "Registrable domains to remove (e.g. ['partnerco.com'])",
            "items": {
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 100,
            "minItems": 1,
            "type": "array"
          }
        },
        "required": [
          "domains"
        ],
        "type": "object"
      },
      "name": "remove_from_allowlist",
      "outputSchema": null
    },
    {
      "description": "Resend the email verification link for an existing Unphurl account.\n\nUse this when a user signed up but their verification link expired (links are valid for 24 hours) and they need a new one. The user's API key won't work until their email is verified.\n\nFor security, the response is always the same regardless of whether the email exists, is already verified, or was rate limited. This prevents account enumeration.\n\nRate limited to 3 requests per email per hour.\n\nThis tool does not require an API key.",
      "inputSchema": {
        "properties": {
          "email": {
            "description": "Email address of the account that needs verification",
            "format": "email",
            "type": "string"
          }
        },
        "required": [
          "email"
        ],
        "type": "object"
      },
      "name": "resend_verification",
      "outputSchema": null
    },
    {
      "description": "Show all 25 scoring signals with their default weights and descriptions. This is the baseline scoring that applies when no custom profile is specified.\n\nUse this to understand what each signal means and how much it contributes to the score before creating custom profiles. Profiles are sparse overrides on top of these defaults.\n\nThis tool does not require an API key. The defaults are hardcoded and always available.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "show_defaults",
      "outputSchema": null
    },
    {
      "description": "Create a new Unphurl account. Returns an API key (shown once, store it securely).\n\nAfter signup, the user must check their email and click the verification link. The API key won't work for URL checks until the email is verified. Verification link expires after 24 hours. If the link expires, use the \"resend_verification\" tool to request a new one.\n\nThe account starts with 20 free pipeline check credits so the user can test with real URLs. Known domain lookups (google.com, github.com, etc.) and cached domain lookups are always free. To check more unknown domains through the full analysis pipeline, the user can purchase credits via the \"purchase\" tool.\n\nOnce the user has their API key, they need to add it to their MCP server configuration as UNPHURL_API_KEY.\n\nThis tool does not require an API key.",
      "inputSchema": {
        "properties": {
          "company": {
            "description": "Company name (optional)",
            "type": "string"
          },
          "email": {
            "description": "Email address for the account",
            "format": "email",
            "type": "string"
          },
          "first_name": {
            "description": "First name (used for personalized emails)",
            "type": "string"
          }
        },
        "required": [
          "email",
          "first_name"
        ],
        "type": "object"
      },
      "name": "signup",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:7833f6f25da9c4a183f36db85a9fd45612e7ffcc911f15338799c68a3feb1dcc | sha256sum