# ReferralHero MCP by usefulapi (io.usefulapi/referralhero): tool descriptions scored

- tools/list taken: 2026-11-02 (UTC)
- From: [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers/io.usefulapi%2Freferralhero/versions/latest)
- Connected to: https://referralhero.usefulapi.io/mcp
- Homepage: https://usefulapi.io/referralhero/
- Repository: https://github.com/m190/usefulapi-mcp
- Scoring rules: v2
- Tools: 28
- Average: 51.0 / 100 (Cloudy)
- Near-identical pairs: 0

This page shows how ReferralHero MCP by usefulapi (io.usefulapi/referralhero)'s tool descriptions scored, the issues found and the names of its tools and parameters. The descriptions are the server's own: read them where the copy came from.

Forecall asked the URL this server lists in the official MCP Registry for its tools/list once, on the date above, without calling any tool. The server may have changed since.

## Across the server

- Minor: 28 tools. Above 25, models start to tell tools apart less well.

## Tools

- `referralhero_get_coupon_group`: 44 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `referralhero_get_leaderboard`: 44 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `referralhero_list_coupon_groups`: 44 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `referralhero_add_coupons`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `referralhero_create_coupon_group`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `referralhero_get_subscriber_by_email`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `referralhero_list_campaign_rewards`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `referralhero_list_campaigns`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `referralhero_list_unlocked_rewards`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `referralhero_search_subscribers_by_name`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `referralhero_list_subscriber_rewards`: 49 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: subscriber_id. Name the tool or the place that returns it, or models look it up first.
- `referralhero_create_campaign`: 50 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `referralhero_get_subscriber_by_referral_code`: 50 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: The name is long (44 characters).
- `referralhero_list_subscribers`: 50 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `referralhero_track_conversion_event`: 50 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `referralhero_update_reward_status`: 50 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: reward_id. Name the tool or the place that returns it, or models look it up first.
- `referralhero_get_subscriber`: 52 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: subscriber_id. Name the tool or the place that returns it, or models look it up first.
- `referralhero_list_referrals`: 52 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: subscriber_id. Name the tool or the place that returns it, or models look it up first.
- `referralhero_qualify_referral`: 52 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: subscriber_id. Name the tool or the place that returns it, or models look it up first.
- `referralhero_add_points`: 53 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `referralhero_add_subscriber`: 53 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `referralhero_track_transaction`: 53 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
- `referralhero_delete_subscriber`: 55 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: subscriber_id. Name the tool or the place that returns it, or models look it up first.
- `referralhero_unlock_promoted_reward`: 55 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: subscriber_id. Name the tool or the place that returns it, or models look it up first.
- `referralhero_update_subscriber`: 55 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: subscriber_id. Name the tool or the place that returns it, or models look it up first.
- `referralhero_unqualify_referral`: 60 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: subscriber_id. Name the tool or the place that returns it, or models look it up first.
- `referralhero_promote_subscriber`: 62 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Required identifiers whose description does not say where the value comes from: subscriber_id. Name the tool or the place that returns it, or models look it up first.
- `referralhero_confirm_referral`: 67 / 100

Is your server listed here and you would rather it were not? Email support@forecall.dev, and we will take it off within 7 days.

[All scored servers](https://forecall.dev/en/servers)
