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

**A partner referral.** Read one lead your agency referred: the company, its website, the contact and your notes. Scope: read.

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

## When to use it

Read one lead your agency referred, in the shape corestack_agency_referrals_list answers. The same as
`GET /api/agency/referrals/{referral}`.

## Inputs

- `referral_id` (integer, required): a referral's `id` from corestack_agency_referrals_list.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "referral_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "referral_id"
  ],
  "type": "object"
}
```

## Refusals

- `forbidden`: your roles do not let you view partner referrals.
- `tenant_mismatch`: no referral of your agency has that id (another agency's referral answers the same).
- 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_referral_get",
  "arguments": {
    "referral_id": 42
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_agency_referral_get with referral_id 42. (A partner referral.) Tell me what it returned.
```

## The same task elsewhere

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