# RevCent MCP Guide: `GetCustomerCards`

AI/MCP-focused guide for retrieving a bounded operational list of RevCent Customer Cards.

---

## 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
GetCustomerCards
```

Title:

```text
Get Customer Cards
```

Purpose:

```text
Return a bounded list of previously created Customer Cards.
```

Use `GetCustomerCards` only for narrow operational retrieval, such as locating cards for a known Customer or reviewing recent card records in a short date window.

Do not use it for reporting or analytics.

---

## Input Schema

Required fields:

| Field | Type | Description |
|---|---:|---|
| `date_start` | integer | Date range start as a Unix timestamp in seconds. |
| `date_end` | integer | Date range end as a Unix timestamp in seconds. |
| `limit` | integer | Number of records to return. Range 1 to 25. Default 25. |
| `page` | integer | Pagination page. |

Optional filters:

| Field | Purpose |
|---|---|
| `metadata_filter` | Filter by one or more metadata name/value pairs. |
| `customer_id` | Filter only cards related to a specific Customer ID. |

Example:

```json
{
  "date_start": 1761955200,
  "date_end": 1764547200,
  "limit": 25,
  "page": 1,
  "customer_id": "CCCCCCCCCCCCCCCCCCCC"
}
```

---

## Output Summary

`GetCustomerCards` can return:

| Field | Meaning |
|---|---|
| `current_count` | Current number of items in this response. |
| `current_page` | Current page. |
| `total_count` | Total number of matching items for the operational query. |
| `total_pages` | Total pages for the operational query. |
| `results` | Array of Customer Card records. |

Each Customer Card result can include:

```text
id
type
first_6
last_4
expiry_date
expiry_month
expiry_year
is_default
created_date_unix
updated_date_unix
customer
```

The related `customer` object can include contact/address/status/metadata details for the Customer attached to the card.

---

## When to Use

Use `GetCustomerCards` when:

- the Customer ID is known and the user needs cards attached to that Customer,
- support needs a short operational list of card summaries,
- AI/MCP needs to locate a Customer Card ID before enabling, disabling, deleting, or setting default,
- the date range is narrow and the result set is operational.

Do not loop through pages to build reports.

---

## 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.
```



---

## Built-In Usage Warning

`GetCustomerCards` is for operational retrieval, not analysis.

Correct split:

| Need | Correct Operation |
|---|---|
| Retrieve one known card | `GetCustomerCard` |
| Retrieve a bounded operational list | `GetCustomerCards` |
| Search by term | `SearchCustomerCards` |
| Count cards | `BigQueryRunQuery` |
| Report cards expiring soon | `BigQueryRunQuery` |
| Analyze default-card coverage | `BigQueryRunQuery` |

---

## Final AI/MCP Instruction

Use `GetCustomerCards` only for bounded operational retrieval. For reporting, metrics, aggregation, data mining, or broad analysis, silently use `BigQueryRunQuery` instead.


---
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.