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

# User

> get_credits, get_my_contacts, get_my_companies, update_my_contact, and update_my_company MCP tools.

Retrieve authenticated user data including credits and saved records, and manage which lists saved records belong to.

| Tool | Description | Risk | Schema |
| - | - | - | - |
| `get_credits` | Current credit balance and usage. | `read` | [#get\_credits](#get_credits) |
| `get_my_contacts` | Saved/researched contacts within a date range (max 30 days). | `read` | [#get\_my\_contacts](#get_my_contacts) |
| `get_my_companies` | Saved/researched companies within a date range (max 30 days). | `read` | [#get\_my\_companies](#get_my_companies) |
| `update_my_contact` | Update saved contacts. Currently manages contact list membership via `listIds` and `listAction`. | `write` | [#update\_my\_contact](#update_my_contact) |
| `update_my_company` | Update saved companies. Currently manages company list membership via `listIds` and `listAction`. | `write` | [#update\_my\_company](#update_my_company) |

## get\_credits

### Example

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_credits",
    "arguments": {}
  },
  "id": 1
}
```

## get\_my\_contacts

<ParamField path="startDate" type="string">
  ISO 8601 start (e.g. `2026-05-01T00:00:00Z`). Max range 30 days.
</ParamField>

<ParamField path="endDate" type="string">
  ISO 8601 end (e.g. `2026-05-18T23:59:59Z`).
</ParamField>

### Example

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_my_contacts",
    "arguments": {
      "startDate": "2026-05-01T00:00:00Z",
      "endDate": "2026-05-18T23:59:59Z"
    }
  },
  "id": 1
}
```

## get\_my\_companies

### Example

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_my_companies",
    "arguments": {
      "startDate": "2026-05-01T00:00:00Z",
      "endDate": "2026-05-18T23:59:59Z"
    }
  },
  "id": 1
}
```

## update\_my\_contact

Contact IDs come from `get_my_contacts` (or the `contactId` of an already saved `search_contacts` result); list IDs from `get_lists` or `create_list`. Returns the contacts that changed plus `skippedContactIds` for any that did not — check it before reporting success. To file contacts into a list as part of researching them, pass `listIds` to `research_contacts` instead.

<ParamField path="contactIds" type="(integer | string)[]" required>
  Saved contact IDs to update (1–500).
</ParamField>

<ParamField path="listIds" type="(integer | string)[]" required>
  List IDs to apply (max 50). May be empty only with `listAction: "replace"`, which clears every list off the contacts.
</ParamField>

<ParamField path="listAction" default="add" type="string">
  `add` keeps existing lists, `remove` drops only the supplied lists, `replace` makes the supplied lists the complete set.
</ParamField>

### Example

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_my_contact",
    "arguments": {
      "contactIds": [456, 789],
      "listIds": [12],
      "listAction": "add"
    }
  },
  "id": 1
}
```

## update\_my\_company

Company IDs come from `get_my_companies`; list IDs from `get_lists` or `create_list`. Returns the companies that changed plus `skippedCompanyIds` for any that did not.

<ParamField path="companyIds" type="(integer | string)[]" required>
  Saved company IDs to update (1–500).
</ParamField>

<ParamField path="listIds" type="(integer | string)[]" required>
  List IDs to apply (max 50). May be empty only with `listAction: "replace"`.
</ParamField>

<ParamField path="listAction" default="add" type="string">
  `add`, `remove`, or `replace`.
</ParamField>

### Example

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_my_company",
    "arguments": {
      "companyIds": [321],
      "listIds": [12],
      "listAction": "replace"
    }
  },
  "id": 1
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.