---
title: "corestack_agency_referrals_list"
url: https://docs.corefinity.com/mcp/tools/corestack_agency_referrals_list
type: tool
last_updated: 2026-11-13
feature: agency
related:
  - https://docs.corefinity.com/api/reference/agency/list-agency-referrals.md
  - https://docs.corefinity.com/guides/agencies/agency-portal.md
---
# corestack_agency_referrals_list

**Partner referrals.** List the leads your agency has referred to Corefinity (Agency Portal › Partner Referrals), newest first. Scope: read.

- Scope: `read`
- Runs as a task: no

## When to use it

List the leads your agency has referred to Corefinity, newest first, as Agency Portal › Partner Referrals in the Control
Panel shows them: the company, its website, the contact, what they pay today and your notes. The same list as
`GET /api/agency/referrals`. Where a referral stands with Corefinity's sales team is not shown here.

## Inputs

- `search` (string, up to 255 characters): part of a company name or website.
- `limit` (integer, 1 to 100, default 25): referrals per page.
- `cursor` (string, up to 10 characters): `next_cursor` from the previous page.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "description": "next_cursor from the previous page.",
      "maxLength": 10,
      "type": "string"
    },
    "limit": {
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "search": {
      "description": "Part of a company name or website.",
      "maxLength": 255,
      "type": "string"
    }
  },
  "type": "object"
}
```

## Refusals

- `forbidden`: your roles do not let you view partner referrals.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_agency_referrals_list",
  "arguments": {
    "search": "example",
    "limit": 25
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_agency_referrals_list with search example, limit 25. (Partner referrals.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/agency/referrals](https://docs.corefinity.com/api/reference/agency/list-agency-referrals.md)
- Guide: [Agency portal](https://docs.corefinity.com/guides/agencies/agency-portal.md)
