> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thatsme.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Issuer MCP

> Issue certificates, query analytics, and export data via AI with the Issuer MCP.

## What is the Issuer MCP?

`thatsme-mcp-issuer` is an MCP server that connects AI assistants such as Claude and Cursor to your issuer account on That's Me. With it, you can issue certificates, check the engagement funnel, and export data using natural language.

**Minimum plan:** Pro. Four of the five tools require a Pro plan or higher.

## Installation (local stdio)

```bash theme={null}
npx -y thatsme-mcp-issuer
```

You need to set the `THATSME_API_KEY` environment variable.

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json theme={null}
{
  "mcpServers": {
    "thatsme-issuer": {
      "command": "npx",
      "args": ["-y", "thatsme-mcp-issuer"],
      "env": {
        "THATSME_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### Cursor

Add to your `.cursor/mcp.json` file:

```json theme={null}
{
  "mcpServers": {
    "thatsme-issuer": {
      "command": "npx",
      "args": ["-y", "thatsme-mcp-issuer"],
      "env": {
        "THATSME_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Remote connection (HTTP/SSE)

For clients that support remote MCP:

```text theme={null}
URL: https://mcp.thatsme.com.br/mcp
Transport: Streamable HTTP
```

Include the `Authorization: Bearer YOUR_API_KEY` header in every request.

## Available tools

### 1. `search_events`

Search events created by your organization.

| Parameter | Type   | Required | Description                            |
| --------- | ------ | -------- | -------------------------------------- |
| `query`   | string | Yes      | Event name                             |
| `limit`   | number | No       | Maximum results (default: 10, max: 50) |

**Example prompt:**

> "List my organization's events containing 'DevFest'"

**Minimum plan:** Starter

***

### 2. `issue_certificates`

Issue digital certificates to a list of recipients.

| Parameter             | Type   | Required | Description                   |
| --------------------- | ------ | -------- | ----------------------------- |
| `event_id`            | string | Yes      | Event ID                      |
| `badge_id`            | string | Yes      | Badge/TM ID                   |
| `recipients`          | array  | Yes      | List of recipients (max: 500) |
| `recipients[].email`  | string | Yes      | Recipient email               |
| `recipients[].name`   | string | Yes      | Full name                     |
| `recipients[].reason` | string | No       | Certification reason          |

**Example prompt:**

> "Issue DevFest 2025 certificates to the 3 speakers: [joao@email.com](mailto:joao@email.com) (Joao Silva), [maria@email.com](mailto:maria@email.com) (Maria Santos), [pedro@email.com](mailto:pedro@email.com) (Pedro Lima)"

**Minimum plan:** Pro

***

### 3. `get_engagement_funnel`

Returns the engagement funnel for an event: issued → accepted → viewed → shared.

| Parameter  | Type   | Required | Description |
| ---------- | ------ | -------- | ----------- |
| `event_id` | string | Yes      | Event ID    |

**Example prompt:**

> "Show the engagement funnel for the DevFest 2025 event"

**Response includes:** counts and calculated rates (`acceptance_rate`, `view_rate`, `share_rate`).

**Minimum plan:** Pro

***

### 4. `list_recipients`

Lists the recipients of an event along with their certificate status: pending, accepted, or refused.

| Parameter  | Type   | Required | Description                                     |
| ---------- | ------ | -------- | ----------------------------------------------- |
| `event_id` | string | Yes      | Event ID                                        |
| `page`     | number | No       | Page (default: 1)                               |
| `status`   | enum   | No       | Filter: `all`, `accepted`, `pending`, `refused` |

**Example prompt:**

> "Who hasn't accepted their certificate for the DevFest 2025 event yet?"

**Note:** Emails are partially masked for privacy, e.g., `jo***@email.com`.

**Minimum plan:** Pro

***

### 5. `export_csv`

Exports issuance data in CSV format.

| Parameter | Type | Required | Description                          |
| --------- | ---- | -------- | ------------------------------------ |
| `period`  | enum | No       | `30d`, `90d`, `all` (default: `30d`) |

**Example prompt:**

> "Export the last 90 days of issuance data as CSV"

**Minimum plan:** Pro

## Getting your API Key

1. Go to [app.thatsme.com.br/settings/integrations](https://app.thatsme.com.br/settings/integrations)
2. Click **New API Key**
3. Copy the key — it will not be shown again

[Full authentication documentation →](/en/api/v1/overview)