# RevCent MCP Guide: `GetCustomerCard`

AI/MCP-focused guide for retrieving one RevCent Customer Card.

---

## Related Documentation

| Guide | Link | Why It Matters |
|---|---|---|
| Customer Card Overview | `https://revcent.com/documentation/markdown/mcp/operation/OverviewCustomerCard.md` | Required overview for understanding Customer Cards, safe card summaries, default payment method behavior, and Customer Card lifecycle. |
| Customer Overview | `https://revcent.com/documentation/markdown/mcp/operation/OverviewCustomer.md` | Explains Customers and how Customer Cards attach to Customer records. |
| GetCustomer | `https://revcent.com/documentation/markdown/mcp/operation/GetCustomer.md` | Retrieve the Customer connected to the card. |
| AddCardToCustomer | `https://revcent.com/documentation/markdown/mcp/operation/AddCardToCustomer.md` | Add a new card to an existing Customer. |
| BigQueryRunQuery | `https://revcent.com/documentation/markdown/mcp/operation/BigQueryRunQuery.md` | Correct operation for reporting, metrics, aggregation, and data mining. |


---

## Operation Summary

Operation:

```text
GetCustomerCard
```

Title:

```text
Get A Customer Card
```

Purpose:

```text
Retrieve the details of a specific Customer Card.
```

A Customer Card is a saved card summary attached to a Customer. RevCent does **not** return full card numbers. The card object exposes safe summary fields such as type, first 6/BIN, last 4, expiry, and default status.

---

## When to Use

Use `GetCustomerCard` when:

- the user provides a Customer Card ID,
- a Customer record contains customer card summaries and one card needs detail review,
- support needs to confirm card type, last 4, expiry, or default status,
- AI/MCP needs to verify the Customer before enabling, disabling, deleting, or setting a default card.

Recommended workflow:

```text
GetCustomerCard
    ↓
Review card summary and related Customer
    ↓
If action is needed, run the correct Customer Card operation
    ↓
GetCustomerCard or GetCustomer to verify result
```

---

## Input Schema

| Field | Type | Required | Description |
|---|---:|---:|---|
| `customer_card_id` | string | Yes | 20-character Customer Card ID. |

Example:

```json
{
  "customer_card_id": "XXXXXXXXXXXXXXXXXXXX"
}
```

---

## Output Summary

`GetCustomerCard` can return:

| Field / Area | Meaning |
|---|---|
| `id` | 20-character Customer Card ID. |
| `type` | Card type. |
| `first_6` | First 6 digits, also known as BIN. |
| `last_4` | Last 4 digits. |
| `expiry_date` | Expiration date in `MM/YY` format. |
| `expiry_month` | Expiration month in `MM` format. |
| `expiry_year` | Expiration year in `YY` format. |
| `is_default` | Whether the card is the Customer's default payment method. |
| `created_date_unix` | Creation timestamp. |
| `updated_date_unix` | Last updated timestamp. |
| `customer` | Related Customer object, including ID, email, phone, address, enabled status, and metadata. |

---

## Safe Card Data Rule

Customer Card records are tokenized/summarized payment records.

AI/MCP should treat the following as safe summaries only:

```text
type
first_6
last_4
expiry_date
expiry_month
expiry_year
is_default
```

Do not ask for or display full card numbers or CVV/card code when retrieving a card. Those values are only used through secure card-add flows and are not returned by `GetCustomerCard`.

---

## Customer-Facing AI Verification Warning

Customer Card records are sensitive payment-method records, even though RevCent only returns safe card summaries such as card type, first 6/BIN, last 4, and expiry.

If this operation is used inside a customer-facing AI flow, such as:

- AI Voice Agent,
- public chatbot,
- customer portal assistant,
- SMS assistant,
- any visitor-facing AI workflow,

AI/MCP should verify that the visitor is actually the Customer or is otherwise authorized before providing card details or taking action.

Recommended rule:

```text
Do not provide Customer Card details or perform Customer Card actions based only on visitor-provided input.
```

Use a secondary value from the retrieved RevCent record, such as customer email or phone from `GetCustomerCard.customer`, `GetCustomer`, or another related record.

Safe flow:

```text
Visitor provides customer/card input
    ↓
AI locates/retrieves the Customer Card
    ↓
AI retrieves or reviews the related Customer
    ↓
AI verifies a secondary value from the retrieved RevCent record
    ↓
AI confirms the requested action
    ↓
Only then provides limited information or performs the operation
```

Do not disclose or request full card numbers, CVV/card code, secrets, or payment credentials in normal public chat. Use secure PCI-appropriate payment collection flows for adding cards.


---

## Reporting Guidance

This operation is not a reporting or analytics tool.

Do not use Customer Card lookup/search or mutation operations for:

- counting,
- aggregations,
- metrics,
- reporting,
- data mining,
- bulk retrieval,
- broad analysis,
- card portfolio analysis,
- card expiry reports,
- default-card reports,
- payment-method performance reports,
- customer segmentation reports.

Use:

```text
BigQueryRunQuery
```

for those purposes.

Important AI/MCP behavior:

```text
If AI/MCP intended to use this operation for reporting, metrics, aggregation, or data mining and then realizes BigQueryRunQuery is the correct operation, it does not need to tell the user about the correction.

It should simply use BigQueryRunQuery instead.
```



---

## Correct Use vs Incorrect Use

| User Intent | Correct Action |
|---|---|
| “Show this Customer Card.” | Use `GetCustomerCard`. |
| “What is the last 4 of this saved card?” | Use `GetCustomerCard` after verification. |
| “Is this the default card?” | Use `GetCustomerCard`. |
| “Show all cards expiring this month.” | Use `BigQueryRunQuery`, not `GetCustomerCard`. |
| “How many customers have Visa cards?” | Use `BigQueryRunQuery`, not `GetCustomerCard`. |

---

## Final AI/MCP Instruction

Use `GetCustomerCard` to retrieve one specific Customer Card by `customer_card_id`. Verify the related Customer before providing card details in customer-facing AI flows. Do not use it for reporting, metrics, aggregation, data mining, or broad analysis.


---
Document Parent Directory
* [Operations](https://revcent.com/documentation/markdown/mcp/operation/index.md) - AI/MCP details and overviews for operations available within the RevCent MCP.