Skip to content

MCP servers › io.usefulapi › referralhero

MCP server · registry snapshot 2026-10-24 · last tested 2026-10-24

io.usefulapi/referralhero

Read ReferralHero campaigns, subscribers, referrals and rewards; add subscribers and points. — the publisher's description

4 of 4 record checks metRead-only · tools listed 2026-10-24version 1.0.0JavaScriptstreamable HTTP28 tools

Summary

io.usefulapi/referralhero is a remote MCP server listed in the official MCP registry at version 1.0.0. On 2026-10-24 ProtocolProbe connected to it in read-only mode and read its inventory: 28 tools, 0 resources and 1 prompt.

Record checks

4 of 4 record checks met · 4 do not apply · 1 not checked

  • met: Registry entry is active and says how to run it
  • met: Source repository link opens
  • met: Repository is not archived
  • met: Code pushed to the repository in the 90 days before our check
  • not checked: Repository publishes a security policy (SECURITY.md)
  • not applicable: Package names its licence with a standard (SPDX) identifier
  • not applicable: The version the registry lists can be installed and is not withdrawn
  • not applicable: npm package carries build provenance (attestation)
  • not applicable: No known critical or high advisory in the package or its dependencies

From public records, not a safety rating. Each check with its reason · Is it safe to install?

Key facts

Runs
remote (hosted by the publisher)
Transport
streamable HTTP
Sign-in
none needed to open a session
Repository
public
Tools
28
Last tested
2026-10-24

Add to your client

Observed fact

This server accepted a session without any credential and lists 15 tools whose name or declaration suggests they change data (referralhero_create_campaign, referralhero_add_subscriber, referralhero_update_subscriber, referralhero_delete_subscriber, referralhero_add_points and 10 more). That is our reading of the names; we did not call them. Source: our connection, 2026-10-24.

How fresh this is

Live-tested
yes, a real session (not a text-only review)
Last tested
2026-10-24
Mode
read-only (no tool calls)
Latest version
1.0.0, published 2026-10-24 (registry, as of the 2026-10-24 snapshot)
First listed version
2026-10-24 (earliest version still in the registry; older removed versions would be earlier)
Registry data
snapshot 2026-10-24
Package and repository
checked 2026-10-24
Engine
mcp-runtime-engine@0.1.0 · sdk@1.32.0

Changes since the last refresh

New in the registry: not in the list of 2026-10-23, listed on 2026-10-24 with version 1.0.0 (published 2026-10-24).

Source: the official MCP Registry list on 2026-10-23 and on 2026-10-24.

What it is

What does this server offer?

Observed inventory
28tools
0resources
1prompts

None of its 28 tools are described as changing anything. For 28 the reading was uncertain, so no mark is shown.

  • referralhero_list_campaigns

    “List the active ReferralHero campaigns (lists) in the account: uuid, name, subscriber count and creation time.”

    Publisher declares: read-only yes · destructive no · open-world yes

    1 input
    • pageinteger“Page number, from 1 (default 1).”
  • referralhero_get_leaderboard

    “The leaderboard of a campaign: its top subscribers (10 to 100) with referral counts, points and position.”

    Publisher declares: read-only yes · destructive no · open-world yes

    2 inputs, 1 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • countinteger“How many top subscribers, 10-100 (default 10).”
  • referralhero_list_campaign_rewards

    “The rewards configured for a campaign (title, description, referrals needed to win each).”

    Publisher declares: read-only yes · destructive no · open-world yes

    1 input, 1 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
  • referralhero_create_campaign

    “WRITE: create a new ReferralHero campaign (list) with a name and a default referral URL.”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    2 inputs, 2 required
    • namestringrequired“Campaign name.”
    • websitestringrequired“Default referral URL (https://...).”
  • referralhero_list_subscribers

    “List the subscribers of a campaign, 50 per page, with referral code, referral link, points, position, people referred, status and referrer.”

    Publisher declares: read-only yes · destructive no · open-world yes

    7 inputs, 1 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • sort_bystring“Sort order.”
    • pageinteger“Page number, from 1 (default 1).”
    • extra_fieldstring“Only subscribers whose extra field has this value.”
    • extra_field_2string“Only subscribers whose extra field 2 has this value.”
    • option_fieldstring“Only subscribers whose option field has this value.”
    • stripe_customer_idstring“Only the subscriber linked to this Stripe customer id.”
  • referralhero_get_subscriber

    “One subscriber by id: contact data, referral code and link, points, position, referrals by level, status, fraud risk level, tags.”

    Publisher declares: read-only yes · destructive no · open-world yes

    2 inputs, 2 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • subscriber_idstringrequired“Subscriber id, e.g.”
  • referralhero_get_subscriber_by_email

    “Find one subscriber of a campaign by email.”

    Publisher declares: read-only yes · destructive no · open-world yes

    2 inputs, 2 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • emailstringrequired“The subscriber's email.”
  • referralhero_get_subscriber_by_referral_code

    “Find the subscriber who owns a referral code (the mwr value in a referral link).”

    Publisher declares: read-only yes · destructive no · open-world yes

    2 inputs, 2 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • referral_codestringrequired“The referrer's referral code (the mwr parameter of a referral link).”
  • referralhero_search_subscribers_by_name

    “Search subscribers by name across all campaigns of the account, 50 per page.”

    Publisher declares: read-only yes · destructive no · open-world yes

    2 inputs, 1 required
    • namestringrequired“Name to search for.”
    • pageinteger“Page number, from 1 (default 1).”
  • referralhero_list_referrals

    “The people a subscriber referred, 50 per page.”

    Publisher declares: read-only yes · destructive no · open-world yes

    5 inputs, 2 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • subscriber_idstringrequired“Subscriber id, e.g.”
    • scopestring“Which referrals (default all).”
    • sort_bystring“Sort order.”
    • pageinteger“Page number, from 1 (default 1).”
  • referralhero_list_unlocked_rewards

    “Rewards unlocked by subscribers across a whole campaign: reward name, status (sent, resent, canceled, pending, flagged), value, subscriber email and id, coupon code, transaction.”

    Publisher declares: read-only yes · destructive no · open-world yes

    4 inputs, 1 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • statusstring“Only rewards in this status.”
    • pageinteger“Page number, from 1 (default 1).”
    • per_pageinteger“Results per page, 1-50 (default 10).”
  • referralhero_list_subscriber_rewards

    “Rewards one subscriber has unlocked, with status, value and coupon code.”

    Publisher declares: read-only yes · destructive no · open-world yes

    4 inputs, 2 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • subscriber_idstringrequired“Subscriber id, e.g.”
    • statusstring“Only rewards in this status.”
    • pageinteger“Page number, from 1 (default 1).”
Show 16 more tools
  • referralhero_list_coupon_groups

    “Coupon groups of a campaign (id, name, active flag, coupons with availability), 50 per page.”

    Publisher declares: read-only yes · destructive no · open-world yes

    2 inputs, 1 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • pageinteger“Page number, from 1 (default 1).”
  • referralhero_get_coupon_group

    “One coupon group with all its coupons (code, available, sent_at).”

    Publisher declares: read-only yes · destructive no · open-world yes

    2 inputs, 2 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • coupon_group_idstringrequired“Coupon group id (see referralhero_list_coupon_groups).”
  • referralhero_add_subscriber

    “WRITE: add a subscriber (or a referred person) to a campaign.”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    23 inputs, 2 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • emailstring“Subscriber email (when email is the campaign's unique identifier).”
    • phone_numberstring“Subscriber phone number (when phone is the unique identifier).”
    • crypto_wallet_addressstring“Wallet address (when it is the unique identifier).”
    • other_identifier_valuestring“Custom identifier value (when a custom id is the unique identifier).”
    • namestring“Subscriber name.”
    • referrerstring“Referral code or email of the referrer to credit.”
    • double_optinboolean“false = do not send the confirmation email.”
    • confirmbooleanrequired“Must be true: the user has approved this change.”
    • statusstring“custom_event_pending = set the referral status to pending (multi-step goals).”
    • pointsinteger“Starting points (contest campaigns only).”
    • transaction_idstring“Unique id of the purchase this referral came from.”
    • conversion_categorystring“Subscriber type for reports and segments.”
    • conversion_valuenumber“Monetary value of the referral.”
    • sourcestring“Source, for analytics.”
    • devicestring“Device used to sign up, for analytics.”
    • extra_fieldstring“Extra field value.”
    • extra_field_2string“Extra field 2 value.”
    • domainstring“URL used for the subscriber's referral link.”
    • stripe_customer_idstring“Stripe customer id to link.”
    • advocate_namestring“Name of the advocate.”
    • self_reported_sourcestring“Where the subscriber says they heard about the campaign.”
    • tagsarray“Tags to assign.”
  • referralhero_update_subscriber

    “WRITE: change fields of a subscriber (overwrites the given fields): name, contact identifiers, extra fields, points (contest campaigns), tags, address, referral status (qualified/unqualified).”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    17 inputs, 3 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • subscriber_idstringrequired“Subscriber id, e.g.”
    • emailstring“Subscriber email (when email is the campaign's unique identifier).”
    • phone_numberstring“Subscriber phone number (when phone is the unique identifier).”
    • crypto_wallet_addressstring“Wallet address (when it is the unique identifier).”
    • other_identifier_valuestring“Custom identifier value (when a custom id is the unique identifier).”
    • namestring“New name.”
    • extra_fieldstring“New extra field value.”
    • extra_field_2string“New extra field 2 value.”
    • pointsinteger“New points total (contest campaigns only).”
    • stripe_customer_idstring“Stripe customer id.”
    • tagsarray“Tags to assign.”
    • addressstring“Address.”
    • citystring“City.”
    • countrystring“Country.”
    • referral_statusstring“Mark the referral qualified or unqualified.”
    • confirmbooleanrequired“Must be true: the user has approved this change.”
  • referralhero_delete_subscriber

    “WRITE, DESTRUCTIVE: permanently delete a subscriber from a campaign, with their referral standing.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    3 inputs, 3 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • subscriber_idstringrequired“Subscriber id, e.g.”
    • confirmbooleanrequired“Must be true: the user has approved permanently deleting this subscriber.”
  • referralhero_add_points

    “WRITE: add points to an existing subscriber (not idempotent: each call adds again).”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    7 inputs, 3 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • emailstring“Subscriber email (when email is the campaign's unique identifier).”
    • phone_numberstring“Subscriber phone number (when phone is the unique identifier).”
    • crypto_wallet_addressstring“Wallet address (when it is the unique identifier).”
    • other_identifier_valuestring“Custom identifier value (when a custom id is the unique identifier).”
    • pointsintegerrequired“Points to add.”
    • confirmbooleanrequired“Must be true: the user has approved this change.”
  • referralhero_track_transaction

    “WRITE: record a purchase/transaction for a subscriber (amount required) so revenue-based rewards and reports count it (not idempotent unless a transaction_id is reused).”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    11 inputs, 3 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • emailstring“Subscriber email (when email is the campaign's unique identifier).”
    • phone_numberstring“Subscriber phone number (when phone is the unique identifier).”
    • crypto_wallet_addressstring“Wallet address (when it is the unique identifier).”
    • other_identifier_valuestring“Custom identifier value (when a custom id is the unique identifier).”
    • amountnumberrequired“Amount of the transaction.”
    • transaction_idstring“Your unique transaction id.”
    • product_idstring“Product id (for product-based rewards).”
    • lifetime_spendnumber“The subscriber's total lifetime spend.”
    • reward_valuenumber“A reward value to attach to the transaction.”
    • confirmbooleanrequired“Must be true: the user has approved this change.”
  • referralhero_confirm_referral

    “WRITE: confirm a verified referral when its third conversion event happens (campaigns whose goal tracks three events; otherwise ReferralHero returns an error).”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    8 inputs, 2 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • subscriber_idstring“Subscriber id, e.g.”
    • emailstring“Subscriber email (when email is the campaign's unique identifier).”
    • phone_numberstring“Subscriber phone number (when phone is the unique identifier).”
    • crypto_wallet_addressstring“Wallet address (when it is the unique identifier).”
    • other_identifier_valuestring“Custom identifier value (when a custom id is the unique identifier).”
    • conversion_valuenumber“Referral conversion value.”
    • confirmbooleanrequired“Must be true: the user has approved this change.”
  • referralhero_track_conversion_event

    “WRITE: report a conversion event for a referral (campaigns whose goal tracks two or three events).”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    12 inputs, 2 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • emailstring“Subscriber email (when email is the campaign's unique identifier).”
    • phone_numberstring“Subscriber phone number (when phone is the unique identifier).”
    • crypto_wallet_addressstring“Wallet address (when it is the unique identifier).”
    • other_identifier_valuestring“Custom identifier value (when a custom id is the unique identifier).”
    • referrerstring“Unique identifier of the referrer (needed to create a missing referral).”
    • conversion_valuenumber“Referral conversion value.”
    • stripe_customer_idstring“Stripe customer id.”
    • transaction_idstring“Transaction id for the event.”
    • product_idstring“Product id (for product-based rewards).”
    • tagsarray“Tags to assign.”
    • confirmbooleanrequired“Must be true: the user has approved this change.”
  • referralhero_qualify_referral

    “WRITE: mark a referral as qualified, so it counts toward the referrer's rewards.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    3 inputs, 3 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • subscriber_idstringrequired“Subscriber id, e.g.”
    • confirmbooleanrequired“Must be true: the user has approved this change.”
  • referralhero_unqualify_referral

    “WRITE: mark a referral as unqualified (for example fraud or a refund), so it no longer counts toward the referrer's rewards.”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    3 inputs, 3 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • subscriber_idstringrequired“Subscriber id, e.g.”
    • confirmbooleanrequired“Must be true: the user has approved this change.”
  • referralhero_promote_subscriber

    “WRITE: promote a subscriber to the campaign's winners list (contests and giveaways).”

    Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

    3 inputs, 3 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • subscriber_idstringrequired“Subscriber id, e.g.”
    • confirmbooleanrequired“Must be true: the user has approved this change.”
  • referralhero_unlock_promoted_reward

    “WRITE: unlock a promoted-winner or one-off reward for a subscriber.”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    4 inputs, 4 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • subscriber_idstringrequired“Subscriber id, e.g.”
    • reward_idstringrequired“Id of the promotion reward (see referralhero_list_campaign_rewards).”
    • confirmbooleanrequired“Must be true: the user has approved delivering this reward to the subscriber now.”
  • referralhero_update_reward_status

    “WRITE: set the status of an unlocked reward to sent, resent or canceled.”

    Publisher declares: read-only no · destructive yes · idempotent no · open-world yes

    4 inputs, 4 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • reward_idstringrequired“Id of the unlocked reward.”
    • statusstringrequired“New status.”
    • confirmbooleanrequired“Must be true: the user has approved this reward status change (sent/resent can email the reward; canceled withdraws it).”
  • referralhero_create_coupon_group

    “WRITE: create a coupon group for a campaign, optionally with its first coupon codes.”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    4 inputs, 2 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • namestringrequired“Coupon group name.”
    • couponsarray“Coupon codes to put in the group.”
    • activeboolean“Whether the group is active (default true).”
  • referralhero_add_coupons

    “WRITE: add coupon codes to an existing coupon group.”

    Publisher declares: read-only no · destructive no · idempotent no · open-world yes

    3 inputs, 3 required
    • uuidstringrequired“Campaign (list) uuid, the 12-character id starting with MF (see referralhero_list_campaigns).”
    • coupon_group_idstringrequired“Coupon group id (see referralhero_list_coupon_groups).”
    • couponsarrayrequired“Coupon codes to add.”

Each quoted sentence is the first sentence of the publisher’s own description. The kind of tool and the “changes data” mark are our AI model’s reading of that description, not something we tested: two differently worded runs had to agree, otherwise no label is shown, and nobody has checked them by hand. A tool without the “changes data” mark is described as only reading, searching or calculating, or the two runs did not agree. No tool was called. Read the publisher’s full description before relying on it. “Publisher declares” lists the hints the server itself sends with the tool (MCP annotations: read-only, destructive, idempotent, open-world); they are the publisher's claims, not checked by us. Inputs are the parameters in the tool's own input schema: name, declared type, whether it is required, and the first sentence of its description. Read 2026-10-24.

How well are its tools described?

Features #4 and #5

How clearly this server's own tool descriptions say what a tool does, and how consistent its tool list is. The first part is an AI model's yes/no reading of each description; the second part is counted. We do not turn it into a grade.

Descriptions

AI reading of each description

No AI reading was available for this server's tools (the two runs did not agree, or the listing was not reviewed).

Counted from the listing

Parameters with a description
100% of 143
Tools with a description
100% of 28
Typical description length
210 characters

The tool set

Counted from the listing

Tools
28
Size of the list
about 9,037 tokens for an agent to load (characters ÷ 4)
Naming
28 of 28 names use snake_case

AI reading: easy to mix up

No pair found.

The AI items cover 0 of 28 tools: for a tool where two differently worded runs disagreed, that item is left out. They were not checked by hand, and no tool was called. “Easy to mix up” means two tools whose names or descriptions overlap without saying how they differ; the AI found none. We do not rate whether the tool set is complete or whether side effects are spelled out, because our AI reading of those was not reliable enough.

How do I add it to my client?

Config from the registry entry

From the remote endpoint (Streamable HTTP)

We connected to this URL on 2026-10-24 (a read-only session: no tool was called).

Add to CursorAn install link in the format Cursor documents, holding the Cursor config below.

Claude Desktop or claude.ai
Settings → Connectors → Add custom connector, then paste:
https://referralhero.usefulapi.io/mcp
Cursor · .cursor/mcp.json in a project, or ~/.cursor/mcp.json
{
  "mcpServers": {
    "referralhero": {
      "url": "https://referralhero.usefulapi.io/mcp"
    }
  }
}
VS Code · .vscode/mcp.json
{
  "servers": {
    "referralhero": {
      "type": "http",
      "url": "https://referralhero.usefulapi.io/mcp"
    }
  }
}
VS Code (command line) · Bash or zsh terminal (macOS, Linux)
code --add-mcp '{"name":"referralhero","type":"http","url":"https://referralhero.usefulapi.io/mcp"}'
Claude Code
claude mcp add --transport http referralhero https://referralhero.usefulapi.io/mcp
Try it in the MCP Inspector · runs on your machine, opens in your browser · Node 22.19+
npx @modelcontextprotocol/inspector@2.11.0 --server-url https://referralhero.usefulapi.io/mcp --transport http
  • The server runs on the operator's infrastructure; it may ask you to sign in when you first connect.
  • The MCP Inspector lists the server's tools, resources and prompts; a tool you call there runs for real.

Built from the server's registry entry with each client's documented format (checked 2026-10-14; the Cursor link and the VS Code command 2026-10-19; the MCP Inspector command 2026-10-21). Values in < > are yours to fill in; this page never contains a key. Where the server needs a setting the entry does not declare, it can still fail to start.

Does the registry listing match what we found?

Feature #6

The registry verifies a package once, when it is published, and does not re-check it. A difference below is about the listing, not a judgement of the publisher.

Registry saysWe foundResultSource · date
Remote endpoint referralhero.usefulapi.io/mcpSession openedmatchesour test · 2026-10-24
No credential declared as requiredOpened a session without any credentialmatchesour test · 2026-10-24
Repository github.com/m190/usefulapi-mcpOpens publiclymatchesapi.github.com · 2026-10-24

Who made it?

Feature #7 · lineage

Facts about the publisher. We do not turn them into a trust score.

Namespace
io.usefulapi · 409 servers
GitHub owner
a personal account (m190)
Repository
github.com/m190/usefulapi-mcp
Stars
0
Repository age
91–180 days
Last push
0–30 days ago
Archived
no

Source: the registry entry and api.github.com · 2026-10-24.

Publish this server? Run these checks against it yourself before release, from your own machine: a server the command starts, or your own server at its URL after a one-time proof that you control it: npx protocolprobe-selftest.

Choosing

Record checks

Public records · not a safety rating

4 of 4 record checks met · 4 do not apply · 1 not checked

  • MetRegistry entry is active and says how to run itActive, with a package or a remote address.
  • MetSource repository link opensThe linked GitHub repository is public.
  • MetRepository is not archivedNot archived.
  • MetCode pushed to the repository in the 90 days before our checkLast push 0-30 days before our check.
  • Not checkedRepository publishes a security policy (SECURITY.md)We did not read this repository's security policy.
  • Does not applyPackage names its licence with a standard (SPDX) identifierRemote server: it ships no package.
  • Does not applyThe version the registry lists can be installed and is not withdrawnRemote server: it ships no package.
  • Does not applynpm package carries build provenance (attestation)Remote server: it ships no package.
  • Does not applyNo known critical or high advisory in the package or its dependenciesRemote server: it ships no package.

Read from public records only: the registry entry, npm/PyPI, GitHub and advisory databases, checked 2026-10-24. No tool was called. Only “met” and “not met” are counted, so the total differs between servers; a check that does not apply or that we could not run is listed, never counted against it. It is not a safety rating. How each check works · Leaderboards

Common questions about io.usefulapi/referralhero

Answered from the data above

Is io.usefulapi/referralhero safe to install?

We do not rate servers as safe or unsafe. 4 of its 4 applicable record checks are met (facts from public records, each listed on this page). What the records show: Its source repository opens publicly. Its repository had a push in the last 90 days. These are facts with their sources on this page, not a safety guarantee, and we did not run its tools.

Does io.usefulapi/referralhero need an API key or sign-in?

It opened a session without any credential on 2026-10-24. The registry entry declares no required credential; no declaration is not a guarantee.

Has io.usefulapi/referralhero been security tested?

Partly. 3 of the 16 checks that apply to it were exercised. It accepted a session without any credential and lists tools whose names suggest they change data. We did not call them. No security verdict is published before verification.

Where is the source code of io.usefulapi/referralhero?

In github.com/m190/usefulapi-mcp, which opens publicly.

Found this page useful?

Anonymous · no sign-in

A quick, anonymous reaction — no account, no email. One per kind from your browser. The tally updates when the page is next refreshed, and it is only a rough count, never a safety rating or a measured number of people.

Compare with another server

Side by side: registry entry, our read-only session, the tools and the 18 classification fields. Same values as each page; no score.

Security testing

What did we test, and what did we leave out?

18 checks · features #1, #2

Open without sign-in

It accepted a session without any credential and lists tools whose names suggest they change data. We did not call them. No security score is given; a check we did not run is never counted as passed.

The 18 checks at a glanceour test · 2026-10-24
  1. Inventory: exercised
  2. Hidden instructions: exercised
  3. Real execution: not run · our policy
  4. Secret leak: not run · nothing to check it against
  5. Internal addresses: not run · our policy
  6. Unconfirmed changes: not run · our policy
  7. Bad input: not run · our policy
  8. Model requests: not run · nothing to check it against
  9. Sensitive questions: not run · nothing to check it against
  10. Folder boundary: not run · our policy
  11. Log leaks: not run · nothing to check it against
  12. Hidden content: not run · nothing to check it against
  13. Fake assistant turns: not run · an error was returned
  14. Token passthrough: not applicable
  15. Token audience: not applicable
  16. Sign-in redirect: not run · our policy
  17. Consent handling: not testable from outside
  18. Sign-in metadata: exercised

3 exercised13 not run (reason given)2 not applicable

Each check ends in exactly one state: exercised, not run (with the reason), or not applicable (with the reason). 3 of the 16 checks that apply to it were exercised. We do not publish security-check outcomes for named servers.

Exercised · 3
  • 1Inventory
    tool-list
    Reads the declared tools, resources and prompts.exercised
  • 2Hidden instructions
    description-poisoning
    Looks for hidden instructions in tool descriptions.exercised
  • 18Sign-in metadata
    oauth-url-scheme
    Checks the published sign-in metadata for unsafe URLs.exercised
Not run, with the reason · 13
  • 3Real execution
    real-execution
    Calls a tool and checks what really happens.This check calls the server's tools. ProtocolProbe calls no server's tools for anything it publishes; an operator can run this check on their own server with our self-test command.not run · our policy
  • 4Secret leak
    canary-leak
    Plants a fake secret and checks whether it leaks.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
  • 5Internal addresses
    ssrf
    Checks whether a tool can be steered to internal addresses.This check calls the server's tools. ProtocolProbe calls no server's tools for anything it publishes; an operator can run this check on their own server with our self-test command.not run · our policy
  • 6Unconfirmed changes
    write-without-confirmation
    Checks whether tools that change data act without asking.This check calls the server's tools. ProtocolProbe calls no server's tools for anything it publishes; an operator can run this check on their own server with our self-test command.not run · our policy
  • 7Bad input
    error-handling
    Sends bad input and watches how the server answers.This check calls the server's tools. ProtocolProbe calls no server's tools for anything it publishes; an operator can run this check on their own server with our self-test command.not run · our policy
  • 8Model requests
    sampling
    Checks whether the server asks the client's model to act for it.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
  • 9Sensitive questions
    elicitation-sensitive-data
    Checks whether the server asks users for sensitive data.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
  • 10Folder boundary
    root-boundary
    Checks whether the server reaches outside the folders it was given.This check calls the server's tools. ProtocolProbe calls no server's tools for anything it publishes; an operator can run this check on their own server with our self-test command.not run · our policy
  • 11Log leaks
    logging-side-channel
    Checks whether log messages carry data they should not.This check needs at least one successful tool call to have something to check, and no tool was called.not run · nothing to check it against
  • 12Hidden content
    audience-hiding
    Checks resources that hide content from the user.This check needs content the server returns, and nothing was read or called.not run · nothing to check it against
  • 13Fake assistant turns
    fake-assistant-turn
    Checks prompts that pose as the assistant's own words.The server returned an error when its prompts were read.not run · an error was returned
  • 16Sign-in redirect
    open-redirect
    Checks the sign-in redirect for abuse.Testing the sign-in redirect means sending probes to the operator's sign-in service, which we do not do.not run · our policy
  • 17Consent handling
    confused-deputy
    Checks consent handling when one service acts for another.Depends on the operator's own consent screen, which differs per server and cannot be tested from outside.not testable from outside
Does not apply to this server · 2
  • 14Token passthrough
    token-passthrough
    Checks whether the server forwards a user's token to other services.The server opened a session without sign-in, so there is no token flow to check.not applicable
  • 15Token audience
    token-audience-validation
    Checks whether tokens meant for another service are accepted.The server opened a session without sign-in, so there is no token flow to check.not applicable

Source: our own test, 2026-10-24, mcp-runtime-engine@0.1.0. Which checks count and why follows our published scoring model.

What happened during the test?

Feature #8

The steps in order, as the test record holds them.

  1. 0 msStarted a read-only session with the server's remote endpoint
  2. 246 msConnected after 0 redirects. No credential was sent or needed.
  3. Read the inventory: 28 tools, 0 resources, 1 prompt.
  4. 945 msFinished: 3 checks exercised.

Reference

How is it classified?

18 fields

One value per field, each with its source. Fields written by AI models are marked. A field with no value says why.

TopicAI-classified
pending: added in the weekly update
listed 2026-10-24; not classified yet
Pricing modelAI-classified
pending: added in the weekly update
the website is not read yet
Programming language
api.github.com · 2026-10-24
Hosting type
registry · 2026-10-24
MCP capability
prompts, tools
our test · 2026-10-24
Transport
streamable HTTP
registry · 2026-10-24
Required credentials
none declared
registry · no declaration is not a guarantee
Package registry
does not apply
remote-only server: no package is shipped, so there is no package registry
Freshness
0–30 days
registry updatedAt · 2026-10-24
Lifecycle status
registry · 2026-10-24
License class
does not apply
remote-only server: ships no package, so there is nothing to look up in a package registry
Integrity hash
does not apply
remote-only server: ships no package, so there is nothing to look up in a package registry
Signature / provenance
does not apply
remote-only server: ships no package, so there is nothing to look up in a package registry
Dependency advisories
does not apply
ships no package, so there are no dependencies to audit
Popularity
does not apply
remote-only server: ships no package, so there is nothing to look up in a package registry
Publisher signals
owner: a personal account · repository age: 91–180 days · stars: 0–9
api.github.com · 2026-10-24
Maintenance
api.github.com · 2026-10-24
Environment
the publisher's infrastructure
where it runs, from the hosting type

“Not stated” means the source did not state it; “does not apply” means it does not apply to this kind of server; “our limit” means our own lookup failed. A linked value opens the directory filtered to the same value.

Cite or correct this page

Sources and corrections

Suggested citation

ProtocolProbe. “io.usefulapi/referralhero: MCP server record.” Data checked 2026-10-24. https://protocolprobe.com/mcp/servers/io.usefulapi/referralhero

Figures are valid for the date shown. Our facts on this page are CC BY 4.0: reuse them with a link and the check date. Quoted text (the publisher’s descriptions, website quotes, tool names) is not ours to license.

As JSON: this record in the API · API documentation.

Badge for your README

ProtocolProbe: 4 of 4 record checks met

[![ProtocolProbe](https://protocolprobe.com/api/v1/badge/io.usefulapi/referralhero)](https://protocolprobe.com/mcp/servers/io.usefulapi/referralhero)

It shows this server's record-check count: facts from public records, no tool called. It is not a security rating or a pass. It links here and updates after each data reload.

Something wrong, or is this yours?

If a fact here is wrong, tell us and we will re-check it. If you operate this server, you can run our checks on it yourself with the free self-test command; we call no server’s tools ourselves for anything shown here.

Write to hello@protocolprobe.com · corrections log · methodology