Skip to main content
Glama

HubVibe: Pay-per-Call Agent Tools: Web Search, Email Verify, KYC Screening, Stocks, Crypto, News

Verify ownership and inspect public identity evidence

hubvibe_identity_check
Read-onlyIdempotent

Non-government identity intelligence: email/DNS/wallet challenge proofs, GitHub and Bluesky public profiles, GLEIF/SEC business records, signed A2A cards and the canonical Base ERC-8004 registry. Separates ownership from public-record matches and unverified claims, with evidence, timestamps and fraud indicators. Required evidence failures refuse delivery. Existing contact screening remains available. No documents or biometrics. $3.00 per call. Returns: verification_status, verified (scoped ownership only), ownership[], findings[], profiles[], businesses[], agent, screening, correlations[], fraud_indicators[], sources[], checked_at, limitations[].

Input Schema

NameRequiredDescriptionDefault
ipNo
nameNo
agentNo
emailNo
phoneNo
domainNo
proofsNo
countryNo
businessNo
languageNoOptional BCP-47 language tag (en, ja, ko, pt-BR): the human-readable strings of the result (notes, details, reasons) are translated into this language; data, codes, numbers and URLs are untouched. Default: as produced.
usernameNo
platformsNo
birth_yearNo
phone_regionNo
required_checksNo

Output Schema

NameRequiredDescriptionDefault
resultYes
statusYes
workerYes
price_usdYes
provenanceYes
receipt_idYes
attributionNo
receipt_urlYes
billing_warningNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed26 schema fields changed
    • removedInput schema / anyOf
      Removed value: -[
      -  {
      -    "required": [
      -      "name"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "email"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "phone"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "ip"
      -    ]
      -  }
      -]
    • addedInput schema / properties / agent
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "agent_id": {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "card_url": {
      +      "format": "uri",
      +      "type": "string"
      +    },
      +    "chain_id": {
      +      "const": 8453,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "card_url"
      +  ],
      +  "type": "object"
      +}
    • removedInput schema / properties / birth_year / description
      Removed value: -"Birth year, to narrow sanctions matches for a person."
    • changedInput schema / properties / birth_year / maximum
      Previous value: -2030New value: +2100
    • changedInput schema / properties / birth_year / minimum
      Previous value: -1880New value: +1900
    • addedInput schema / properties / business
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "cik": {
      +      "type": [
      +        "integer",
      +        "string"
      +      ]
      +    },
      +    "lei": {
      +      "pattern": "^[A-Z0-9]{18}[0-9]{2}$",
      +      "type": "string"
      +    },
      +    "name": {
      +      "maxLength": 200,
      +      "minLength": 2,
      +      "type": "string"
      +    }
      +  },
      +  "required": [],
      +  "type": "object"
      +}
    • removedInput schema / properties / country / description
      Removed value: -"Country the person says they are in (US or United States), compared with phone and IP."
    • removedInput schema / properties / country / minLength
      Removed value: -2
    • addedInput schema / properties / domain
      Added value: +{
      +  "maxLength": 253,
      +  "type": "string"
      +}
    • removedInput schema / properties / email / description
      Removed value: -"Email address to verify."
    • changedInput schema / properties / email / maxLength
      Previous value: -320New value: +254
    • removedInput schema / properties / email / minLength
      Removed value: -3
    • removedInput schema / properties / ip / description
      Removed value: -"The client's IPv4 or IPv6 address."
    • changedInput schema / properties / ip / maxLength
      Previous value: -45New value: +50
    • removedInput schema / properties / ip / minLength
      Removed value: -2
    • removedInput schema / properties / name / description
      Removed value: -"Person or company name to screen against sanctions lists."
    • removedInput schema / properties / name / minLength
      Removed value: -2
    • removedInput schema / properties / phone / description
      Removed value: -"Phone number, international (+44 20 7946 0958) or national with `phone_region`."
    • removedInput schema / properties / phone / minLength
      Removed value: -3
    • removedInput schema / properties / phone_region / description
      Removed value: -"Two-letter country for a national-format phone number."
    • addedInput schema / properties / phone_region / maxLength
      Added value: +3
    • removedInput schema / properties / phone_region / pattern
      Removed value: -"^[A-Za-z]{2}$"
    • addedInput schema / properties / platforms
      Added value: +{
      +  "items": {
      +    "enum": [
      +      "github",
      +      "bluesky"
      +    ]
      +  },
      +  "maxItems": 2,
      +  "minItems": 1,
      +  "type": "array",
      +  "uniqueItems": true
      +}
    • addedInput schema / properties / proofs
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "access_token": {
      +        "pattern": "^[0-9a-f]{64}$",
      +        "type": "string",
      +        "writeOnly": true
      +      },
      +      "challenge_id": {
      +        "pattern": "^own_[0-9a-f]{32}$",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "challenge_id",
      +      "access_token"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 5,
      +  "type": "array"
      +}
    • addedInput schema / properties / required_checks
      Added value: +{
      +  "items": {
      +    "enum": [
      +      "email_ownership",
      +      "domain_ownership",
      +      "wallet_ownership",
      +      "usernames",
      +      "business",
      +      "agent",
      +      "screening"
      +    ]
      +  },
      +  "type": "array",
      +  "uniqueItems": true
      +}
    • addedInput schema / properties / username
      Added value: +{
      +  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]{0,79}$",
      +  "type": "string"
      +}
  2. Changed23 schema fields changed
    • removedOutput schema / description
      Removed value: -"The 200 body of every paid /work call. `result` is the worker's own output (its schema is per route); everything else is the same on every /work route. A receipt for the job is at `receipt_url`."
    • removedOutput schema / properties / attribution / description
      Removed value: -"Present only when the result's text was machine-translated: the credit to show with it."
    • removedOutput schema / properties / attribution / items / description
      Removed value: -"A credit."
    • removedOutput schema / properties / attribution / items / properties
      Removed value: -{
      -  "text": {
      -    "description": "Credit.",
      -    "examples": [
      -      "Translated by Google"
      -    ],
      -    "type": "string"
      -  },
      -  "url": {
      -    "description": "Link.",
      -    "examples": [
      -      "https://translate.google.com"
      -    ],
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / properties / attribution / items / required
      Removed value: -[
      -  "text",
      -  "url"
      -]
    • removedOutput schema / properties / attribution / items / type
      Removed value: -"object"
    • removedOutput schema / properties / billing_warning / description
      Removed value: -"Present only when the charge was recorded with a caveat."
    • removedOutput schema / properties / billing_warning / examples
      Removed value: -[
      -  "settlement pending"
      -]
    • removedOutput schema / properties / price_usd / description
      Removed value: -"What this call cost, in USD."
    • removedOutput schema / properties / price_usd / examples
      Removed value: -[
      -  0.02
      -]
    • removedOutput schema / properties / provenance / description
      Removed value: -"How the result was produced: which providers ran and how long each took."
    • removedOutput schema / properties / provenance / properties
      Removed value: -{
      -  "attempts": {
      -    "description": "Provider attempts made, including retries and failovers.",
      -    "examples": [
      -      1
      -    ],
      -    "type": "integer"
      -  },
      -  "elapsed_ms": {
      -    "description": "Wall-clock milliseconds for the whole job.",
      -    "examples": [
      -      340
      -    ],
      -    "type": "integer"
      -  },
      -  "providers_used": {
      -    "description": "Providers that served the job.",
      -    "examples": [
      -      [
      -        "coinbase-advanced-trade-public"
      -      ]
      -    ],
      -    "items": {
      -      "description": "Provider name.",
      -      "examples": [
      -        "coinbase-advanced-trade-public"
      -      ],
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "steps": {
      -    "description": "Every step the job ran, in order.",
      -    "items": {
      -      "description": "One step of the job.",
      -      "properties": {
      -        "ms": {
      -          "description": "Milliseconds the step took.",
      -          "examples": [
      -            312
      -          ],
      -          "type": "integer"
      -        },
      -        "ok": {
      -          "description": "Whether the step succeeded.",
      -          "examples": [
      -            true
      -          ],
      -          "type": "boolean"
      -        },
      -        "provider": {
      -          "description": "Provider that served the step.",
      -          "examples": [
      -            "coinbase-advanced-trade-public"
      -          ],
      -          "type": "string"
      -        },
      -        "reason": {
      -          "description": "Failure reason, on a failed step.",
      -          "examples": [
      -            "provider_timeout"
      -          ],
      -          "type": "string"
      -        },
      -        "step": {
      -          "description": "Step name inside the worker.",
      -          "examples": [
      -            "quote"
      -          ],
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "step",
      -        "ok",
      -        "ms"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  }
      -}
    • removedOutput schema / properties / provenance / required
      Removed value: -[
      -  "steps",
      -  "providers_used",
      -  "attempts",
      -  "elapsed_ms"
      -]
    • removedOutput schema / properties / receipt_id / description
      Removed value: -"Receipt id for this job."
    • removedOutput schema / properties / receipt_id / examples
      Removed value: -[
      -  "rcpt_9f1c2b3a4d5e6f70"
      -]
    • removedOutput schema / properties / receipt_url / description
      Removed value: -"Where to fetch the machine-readable receipt (free, no payment)."
    • removedOutput schema / properties / receipt_url / examples
      Removed value: -[
      -  "/work/receipts/rcpt_9f1c2b3a4d5e6f70"
      -]
    • removedOutput schema / properties / result / properties
      Removed value: -{
      -  "checked_at": {
      -    "description": "When this node read the source (UTC). Nothing here is cached.",
      -    "examples": [
      -      "2026-09-26T18:00:00Z"
      -    ],
      -    "format": "date-time",
      -    "type": "string"
      -  },
      -  "checks": {
      -    "description": "Each check's result; null when not asked for or failed.",
      -    "properties": {
      -      "email": {
      -        "description": "email.verify result (verdict, reason, disposable, role_account, free_provider, did_you_mean...), or null.",
      -        "properties": {
      -          "reason": {
      -            "description": "Why.",
      -            "examples": [
      -              "mailbox_exists"
      -            ],
      -            "type": "string"
      -          },
      -          "verdict": {
      -            "description": "email.verify verdict.",
      -            "examples": [
      -              "deliverable"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "verdict",
      -          "reason"
      -        ],
      -        "type": [
      -          "object",
      -          "null"
      -        ]
      -      },
      -      "ip": {
      -        "description": "ip.lookup result (scope, location, network, reverse_dns, attribution), or null.",
      -        "properties": {
      -          "scope": {
      -            "description": "public, private, reserved...",
      -            "examples": [
      -              "public"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "scope"
      -        ],
      -        "type": [
      -          "object",
      -          "null"
      -        ]
      -      },
      -      "phone": {
      -        "description": "phone.parse result (valid, e164, country, region, carrier, line_type), or null.",
      -        "properties": {
      -          "line_type": {
      -            "description": "Line type.",
      -            "examples": [
      -              "fixed_line"
      -            ],
      -            "type": "string"
      -          },
      -          "valid": {
      -            "description": "Valid number.",
      -            "examples": [
      -              true
      -            ],
      -            "type": "boolean"
      -          }
      -        },
      -        "required": [
      -          "valid",
      -          "line_type"
      -        ],
      -        "type": [
      -          "object",
      -          "null"
      -        ]
      -      },
      -      "sanctions": {
      -        "description": "sanctions.screen result (verdict, match_count, matches[], lists[]), or null.",
      -        "properties": {
      -          "match_count": {
      -            "description": "Matches.",
      -            "examples": [
      -              0
      -            ],
      -            "type": "integer"
      -          },
      -          "verdict": {
      -            "description": "Screen verdict.",
      -            "enum": [
      -              "potential_match",
      -              "no_match",
      -              "incomplete"
      -            ],
      -            "examples": [
      -              "no_match"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "verdict",
      -          "match_count"
      -        ],
      -        "type": [
      -          "object",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "sanctions",
      -      "email",
      -      "phone",
      -      "ip"
      -    ],
      -    "type": "object"
      -  },
      -  "checks_failed": {
      -    "description": "Checks that failed; the rest still ship.",
      -    "examples": [
      -      []
      -    ],
      -    "items": {
      -      "description": "A check that did not complete.",
      -      "examples": [
      -        "email"
      -      ],
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "checks_run": {
      -    "description": "Checks that completed.",
      -    "examples": [
      -      [
      -        "sanctions",
      -        "email"
      -      ]
      -    ],
      -    "items": {
      -      "description": "A check that completed.",
      -      "examples": [
      -        "sanctions"
      -      ],
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "flags": {
      -    "description": "Everything worth a look, most severe first.",
      -    "examples": [
      -      []
      -    ],
      -    "items": {
      -      "properties": {
      -        "code": {
      -          "description": "Flag code.",
      -          "examples": [
      -            "country_mismatch_ip"
      -          ],
      -          "type": "string"
      -        },
      -        "detail": {
      -          "description": "What was found.",
      -          "examples": [
      -            "Stated country GB but the ip is in United States."
      -          ],
      -          "type": "string"
      -        },
      -        "severity": {
      -          "description": "How much it matters.",
      -          "enum": [
      -            "high",
      -            "medium",
      -            "low"
      -          ],
      -          "examples": [
      -            "low"
      -          ],
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "code",
      -        "severity",
      -        "detail"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "input": {
      -    "description": "What was checked.",
      -    "properties": {
      -      "birth_year": {
      -        "description": "Birth year given.",
      -        "examples": [
      -          1980
      -        ],
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "country": {
      -        "description": "Stated country.",
      -        "examples": [
      -          "GB"
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "email": {
      -        "description": "Email checked.",
      -        "examples": [
      -          "jane@stripe.com"
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "ip": {
      -        "description": "IP checked.",
      -        "examples": [
      -          "8.8.8.8"
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "name": {
      -        "description": "Name screened.",
      -        "examples": [
      -          "Jane Smith"
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "phone": {
      -        "description": "Phone checked.",
      -        "examples": [
      -          "+44 20 7031 3000"
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "name",
      -      "email",
      -      "phone",
      -      "ip",
      -      "country",
      -      "birth_year"
      -    ],
      -    "type": "object"
      -  },
      -  "notes": {
      -    "description": "Notes.",
      -    "examples": [
      -      []
      -    ],
      -    "items": {
      -      "description": "A note.",
      -      "examples": [
      -        "Flags are leads to review, not a determination."
      -      ],
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "risk": {
      -    "description": "high: a high-severity flag (sanctions match). review: a medium flag. low: none or only low flags.",
      -    "enum": [
      -      "low",
      -      "review",
      -      "high"
      -    ],
      -    "examples": [
      -      "review"
      -    ],
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / properties / result / required
      Removed value: -[
      -  "input",
      -  "risk",
      -  "flags",
      -  "checks",
      -  "checks_run",
      -  "checks_failed",
      -  "notes",
      -  "checked_at"
      -]
    • removedOutput schema / properties / status / description
      Removed value: -"Present only on a delivered result."
    • removedOutput schema / properties / worker / description
      Removed value: -"Catalog name of the worker that ran."
    • removedOutput schema / properties / worker / examples
      Removed value: -[
      -  "market.quote"
      -]
    • removedOutput schema / title
      Removed value: -"identity.check response"
  3. Added

TDQS

B3.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/idempotent/openWorld and non-destructive, so the safety profile is covered. The description adds genuinely non-derivable behavior: a $3.00 per-call cost, that failing required evidence refuses delivery, that 'verified' is scoped to ownership only, and that public-record matches and unverified claims are separated. It does not mention rate limits or upstream source failure behavior, keeping it out of the top band.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The first sentence is a strong front-loaded scope statement, but the body is a run-on catalogue of sources and the final sentence enumerates every return field, which duplicates the output schema. Several clauses (fraud indicators, timestamps, correlations) restate return values rather than helping the agent call the tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 15-parameter, nested-object, open-world tool the description does cover purpose, cost, refusal semantics and the verified/claims distinction, and the output schema handles returns. Still missing is how the optional inputs compose into a check (e.g. proofs + required_checks + agent), which is the main thing an agent needs to invoke it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 7% against 15 parameters, including nested objects (agent, business, proofs), so the description must carry the semantic load and largely does not. It names evidence domains (email, DNS, wallet proofs, GitHub/Bluesky, GLEIF/SEC), which loosely maps to email/domain/proofs/platforms/business, but nothing explains required_checks, proofs challenge_id/access_token mechanics, phone/birth_year, or why all params are optional.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific resource with concrete scope: email/DNS/wallet challenge proofs, GitHub/Bluesky profiles, GLEIF/SEC records and the Base ERC-8004 registry. It is clearly an identity-evidence aggregator rather than a plain email or DNS check. It loses a point because the enumeration is dense and no sibling is named directly, so the boundary against hubvibe_email_verify, hubvibe_domain_dns or hubvibe_company_enrich is only implied.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives explicit exclusions ('No documents or biometrics') and a note that 'Existing contact screening remains available', which hints at hubvibe_contact_screen. However, it never states when an agent should pick this over the many overlapping siblings (email_verify, domain_dns, sanctions_screen, company_enrich), so usage is inferable but not routed.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.