get_contact — Retrieve a single contact

The get_contact tool returns a single contact by contactId within an organization. Use it to resolve the contactId on an invoice. intent, organizationId, and contactId are required, and the token must carry the contacts.read scope.

Receivables tools require the organization to have invoicing set up in Relay. If it does not, the tool returns an error instead of data.

Scope

Required OAuth scope: contacts.read

Input

string

required

The organization that owns the contact. Must be one of the organizations the token can access.

string

required

The unique contact identifier to retrieve.

string

required

What the user asked for and why this call serves it, in 1 to 500 characters. Required on every tool call. See Common tool arguments.

Output

Contact

required

The requested contact.

Show Contact

string

required

Unique contact identifier. Use this value as contactId.

string

required

Organization the contact belongs to.

string

required

Contact status. Values: active, archived.

string

required

Display name of the contact.

string

required

Email address of the contact.

string

required

Phone number of the contact.

object | null

required

Postal address of the contact, or null when none is on file.

string

required

Where the contact was created or synced from. Values: relay, quickbooks, xero, import.

string

required

Timestamp when the contact was created, in RFC 3339 format.

string

required

Timestamp when the contact was last updated, in RFC 3339 format.

Example

{
  "jsonrpc": "2.0",
  "id": 11,
  "method": "tools/call",
  "params": {
    "name": "get_contact",
    "arguments": {
      "intent": "User asked who invoice INV-0042 was billed to.",
      "organizationId": "org_1",
      "contactId": "ct_1"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 11,
  "result": {
    "structuredContent": {
      "data": {
        "id": "ct_1",
        "organizationId": "org_1",
        "status": "active",
        "name": "Northwind Traders",
        "email": "billing@example.com",
        "phoneNumber": "+1 555 010 0100",
        "address": null,
        "source": "relay",
        "createdAt": "2026-03-02T15:04:00.000Z",
        "updatedAt": "2026-09-14T10:22:00.000Z"
      }
    }
  }
}

Notes

If the contact does not exist or is not accessible with the provided token, the tool returns an MCP error: Contact not found or not accessible.

list_contacts

Search and list contacts.

get_invoice

Fetch an invoice and its contactId.

Organizations

Transactions

Accounts

Cards

Statements

Contacts

Catalog items

Invoices

get_contact — Retrieve a single contact

Scope

Input

Output

Example

Notes

list_contacts

get_invoice

​Scope

​Input

​Output

​Example

​Notes

list_contacts

get_invoice

Scope

Input

Output

Example

Notes