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

# Overview

> Connect Claude, ChatGPT, Perplexity, and other MCP clients to Tyms so your AI assistant can read — and optionally write — your accounting data securely.

The **Tyms MCP server** lets AI assistants work directly with your Tyms business through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io).

Once connected, your assistant can:

* Look up accounts, contacts, invoices, bills, expenses, income, inventory, and more
* Run financial reports (balance sheet, P\&L, cash flow, trial balance, ledgers)
* With the **full** endpoint: create, update, and delete records — including AI-assisted creation powered by **Adam**, Tyms’ AI agent

Tyms MCP is a **hosted remote MCP server**. You do not install a local package. Your client connects over HTTPS and authenticates with OAuth against your Tyms business.

<Note>
  MCP access is available in **production**. Use the [production endpoints](/mcp/endpoints) below.
</Note>

## Who this is for

<CardGroup cols={2}>
  <Card title="Business owners & accountants" icon="user">
    Connect Claude, ChatGPT, or Perplexity to ask questions about your books, pull reports, or (with care) bookkeep in plain language.
  </Card>

  <Card title="Teams using AI tools" icon="users">
    Start on **read-only**, then enable write access only for trusted workflows that need to create or change records.
  </Card>
</CardGroup>

## What you need

1. A Tyms business you can sign into
2. An MCP client that supports **remote MCP** and **OAuth** (Claude, ChatGPT, and Perplexity are supported with dedicated Client IDs)
3. The correct [MCP URL](/mcp/endpoints) and the **Client ID for your platform**

## Quick start

<Steps>
  <Step title="Pick an access level">
    Use **read-only** for lookups and reports, or **/full** only if you need the assistant to create, update, or delete data. See [Endpoints](/mcp/endpoints).
  </Step>

  <Step title="Add Tyms in your MCP client">
    Follow the guide for [Claude.ai](/mcp/clients/claude-ai), [Claude Desktop](/mcp/clients/claude-desktop), [Claude Code](/mcp/clients/claude-code), [ChatGPT](/mcp/clients/chatgpt), or [Perplexity](/mcp/clients/perplexity).
  </Step>

  <Step title="Enter the Client ID if asked">
    Use the Client ID for **your** platform (Claude, ChatGPT, Perplexity, or the generic ID for other apps). See [Authentication](/mcp/authentication).
  </Step>

  <Step title="Approve access in Tyms">
    Sign in, choose the business, and finish OAuth. Then enable the Tyms connector in a chat and start asking questions.
  </Step>
</Steps>

## Connection details (quick reference)

| Field                         | Value                          |
| ----------------------------- | ------------------------------ |
| **Server URL (read-only)**    | `https://mcp.usetyms.com`      |
| **Server URL (read + write)** | `https://mcp.usetyms.com/full` |
| **Auth**                      | OAuth                          |
| **Client ID (Claude)**        | `usetyms-mcp-claude`           |
| **Client ID (ChatGPT)**       | `usetyms-mcp-chatgpt`          |
| **Client ID (Perplexity)**    | `usetyms-mcp-perplexity`       |
| **Client ID (other clients)** | `usetyms-mcp-client`           |

<Important>
  When your MCP client asks for a **Client ID**, use the ID that matches that platform. Do not mix them up — for example, Claude should use `usetyms-mcp-claude`, not the ChatGPT or generic ID.
</Important>

## Where to go next

<Columns cols={2}>
  <Card title="Endpoints" icon="link" href="/mcp/endpoints">
    Read-only vs full URLs and when to use each.
  </Card>

  <Card title="Authentication" icon="key" href="/mcp/authentication">
    How OAuth works and which Client ID to use.
  </Card>

  <Card title="Supported clients" icon="plug" href="/mcp/clients/claude-ai">
    Step-by-step setup for Claude, ChatGPT, Perplexity, and more.
  </Card>

  <Card title="What MCP can do" icon="list-check" href="/mcp/capabilities">
    Tools by domain — accounts, invoices, reports, and more.
  </Card>
</Columns>