Referrals.com MCP by usefulapi

Read brands, campaigns and stats; create or update brands and campaigns in Referrals.com.

使うべきか

品質と安全性

A
説明の品質
100%
スキーマの完全性
79%
命名の品質
77%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

検出事項(2)

  • LOWTool 'referrals_com_get_campaign_stats' name length outside 3-30 rangereferrals_com_get_campaign_stats 内
  • LOWTool 'referrals_com_list_participants' name length outside 3-30 rangereferrals_com_list_participants 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~2,189トークン数(ツール定義)
~1011 B一般的なレスポンスサイズ
注意への影響は中程度(128k コンテキストの 1.71%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `claude_desktop_config.json` ファイルに追加してください:

{
  "mcpServers": {
    "referrals-com": {
      "url": "https://referrals-com.usefulapi.io/mcp"
    }
  }
}

リモートエンドポイント

https://referrals-com.usefulapi.io/mcpstreamable-http

できること

ツール一覧

ツール(15)

🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢referrals_com_get_profile

Get the Referrals.com account that the API key belongs to: name, email and plan. Good first call to confirm the key works. API: GET /v1/members/profile.

入力スキーマ

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢referrals_com_list_brands(page, limit)

List the brands (websites) in the account. A brand owns campaigns. API: GET /v1/brands.

入力スキーマ

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number, starting at 1.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Items per page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢referrals_com_get_brand(brand_id)

Get one brand by id: its URL, domain, description and logo. API: GET /v1/brands/{brandId}.

入力スキーマ

{
  "type": "object",
  "properties": {
    "brand_id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      ],
      "description": "Brand id, from referrals_com_list_brands."
    }
  },
  "required": [
    "brand_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢referrals_com_get_brand_stats(brand_id)

Get analytics for one brand: campaigns, participants, shares, clicks and impressions. API: GET /v1/brands/{brandId}/stats.

入力スキーマ

{
  "type": "object",
  "properties": {
    "brand_id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      ],
      "description": "Brand id."
    }
  },
  "required": [
    "brand_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴referrals_com_create_brand(url, description)

Create a brand (a website that runs referral campaigns). Creates a new record; it is not undone by a retry. API: POST /v1/brands.

入力スキーマ

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The brand website, for example https://mybrand.com."
    },
    "description": {
      "description": "Short description of the brand.",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴referrals_com_update_brand(brand_id, description, logo_url)

Change a brand's description or logo URL. Fields you omit stay as they are. API: PUT /v1/brands/{brandId}.

入力スキーマ

{
  "type": "object",
  "properties": {
    "brand_id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      ],
      "description": "Brand id to change."
    },
    "description": {
      "description": "New description.",
      "type": "string"
    },
    "logo_url": {
      "description": "New logo image URL.",
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "brand_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢referrals_com_list_campaigns(brand_id, page, limit)

List campaigns, optionally for one brand. API: GET /v1/campaigns.

入力スキーマ

{
  "type": "object",
  "properties": {
    "brand_id": {
      "description": "Only campaigns of this brand.",
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      ]
    },
    "page": {
      "description": "Page number, starting at 1.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Items per page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢referrals_com_get_campaign(campaign_id)

Get one campaign with its widget, reward and contest settings. API: GET /v1/campaigns/{campaignId}.

入力スキーマ

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      ],
      "description": "Campaign id, from referrals_com_list_campaigns."
    }
  },
  "required": [
    "campaign_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢referrals_com_get_campaign_stats(campaign_id)

Get campaign stats: participants, shares, clicks, impressions and daily signups. API: GET /v1/campaigns/{campaignId}/stats.

入力スキーマ

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      ],
      "description": "Campaign id."
    }
  },
  "required": [
    "campaign_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴referrals_com_create_campaign(name, brand_id, type_id, reward_type)

Create a campaign under a brand. Creates a new record. The reward_type and type_id codes are not listed in the public docs: check them in the dashboard first. API: POST /v1/campaigns.

入力スキーマ

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign name, for example Summer Promo."
    },
    "brand_id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      ],
      "description": "Brand the campaign belongs to (the API field is url_id)."
    },
    "type_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Campaign type code (from the dashboard)."
    },
    "reward_type": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Reward type code (from the dashboard)."
    }
  },
  "required": [
    "name",
    "brand_id",
    "type_id",
    "reward_type"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴referrals_com_update_campaign(campaign_id, name, publish)

Change a campaign's name or publish setting. Fields you omit stay as they are. API: PUT /v1/campaigns/{campaignId}.

入力スキーマ

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      ],
      "description": "Campaign id to change."
    },
    "name": {
      "description": "New campaign name.",
      "type": "string",
      "minLength": 1
    },
    "publish": {
      "description": "Publish setting as the API takes it, for example public.",
      "type": "string"
    }
  },
  "required": [
    "campaign_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢referrals_com_list_participants(campaign_id, page, limit)

List participants (people who joined a referral campaign), optionally for one campaign. API: GET /v1/participants.

入力スキーマ

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "description": "Only participants of this campaign.",
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      ]
    },
    "page": {
      "description": "Page number, starting at 1.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Items per page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢referrals_com_get_participant(participant_id)

Get one participant with their shares, rewards and invited emails. API: GET /v1/participants/{participantId}.

入力スキーマ

{
  "type": "object",
  "properties": {
    "participant_id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      ],
      "description": "Participant id, from referrals_com_list_participants."
    }
  },
  "required": [
    "participant_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢referrals_com_list_webhooks

List the webhook URLs registered in the account. API: GET /v1/webhooks.

入力スキーマ

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢referrals_com_get_lander(campaign_id)

Get the lander page settings of one campaign: template, header and footer text, background, brand and social links. API: GET /v1/lander.

入力スキーマ

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      ],
      "description": "Campaign id."
    }
  },
  "required": [
    "campaign_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 15 件