# Chit Chats MCP by usefulapi

> Chit Chats MCP by usefulapi is an MCP server. List shipments, batches and returns, and create shipments or change batches in Chit Chats. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/chit-chats/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/chit-chats
- **MCP Registry name:** io.usefulapi/chit-chats
- **Listing updated:** 2026-11-13

## About

List shipments, batches and returns, and create shipments or change batches in Chit Chats.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http chit-chats https://chit-chats.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://chit-chats.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "chit-chats": {
      "url": "https://chit-chats.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "chit-chats": {
      "type": "http",
      "url": "https://chit-chats.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "chit-chats": {
      "serverUrl": "https://chit-chats.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "chit-chats": {
      "type": "http",
      "url": "https://chit-chats.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `chitchats_list_shipments`: List shipments, newest first. Filter by status (pending, ready, in_transit, received, released, inducted, resolved, delivered, exception, voided). Good first call to find shipment ids. Chit Chats API: GET /api/v1/clients/{client_id}/shipments.
- `chitchats_get_shipment`: Get one shipment: addresses, status, carrier and tracking code, purchase amount, label URLs, line items and rates. Chit Chats API: GET /api/v1/clients/{client_id}/shipments/{id}.
- `chitchats_count_shipments`: Count all shipments on the account. Chit Chats API: GET /api/v1/clients/{client_id}/shipments/count.
- `chitchats_list_batches`: List batches (groups of shipments handed to Chit Chats), newest first. Filter by status: pending, ready (all shipments ready to receive) or received. Chit Chats API: GET /api/v1/clients/{client_id}/batches.
- `chitchats_get_batch`: Get one batch with its status and description. Chit Chats API: GET /api/v1/clients/{client_id}/batches/{id}.
- `chitchats_count_batches`: Count all batches on the account. Chit Chats API: GET /api/v1/clients/{client_id}/batches/count.
- `chitchats_list_returns`: List returned shipments, newest first, with status (on_hold, in_transit, ready, resolved) and return reason. Chit Chats API: GET /api/v1/clients/{client_id}/returns.
- `chitchats_create_shipment`: Create a shipment record. The new shipment has status unpaid: this call does NOT buy postage, and no credits are spent. Buy postage in the Chit Chats dashboard. Use postage_type 'unknown' to see rates first. Chit Chats API: POST /api/v1/clients/{client_id}/shipments.
- `chitchats_refresh_shipment_rates`: Change the options of a shipment and recalculate its rates (insurance, signature, hazmat, ship date). This does NOT buy postage. Chit Chats API: PATCH /api/v1/clients/{client_id}/shipments/{id}/refresh.
- `chitchats_add_shipments_to_batch`: Put shipments into a batch. Calling it again with the same shipments changes nothing. Chit Chats API: PATCH /api/v1/clients/{client_id}/shipments/add_to_batch.
- `chitchats_remove_shipments_from_batch`: Take shipments out of the batch they belong to. Calling it again with the same shipments changes nothing. Chit Chats API: PATCH /api/v1/clients/{client_id}/shipments/remove_from_batch.

## FAQ

### How do I add Chit Chats MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http chit-chats https://chit-chats.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/chit-chats-mcp-by-usefulapi
