> ## Documentation Index
> Fetch the complete documentation index at: https://developer.tyms.io/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](https://developer.tyms.io/mcp/endpoints.md) below.

## Who this is for

> **Business owners & accountants**
>
> Connect Claude, ChatGPT, or Perplexity to ask questions about your books, pull reports, or (with care) bookkeep in plain language.

> **Teams using AI tools**
>
> Start on **read-only**, then enable write access only for trusted workflows that need to create or change records.

## 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](https://developer.tyms.io/mcp/endpoints.md) and the **Client ID for your platform**

## Quick start

**1. 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](https://developer.tyms.io/mcp/endpoints.md).

**2. Add Tyms in your MCP client**

Follow the guide for [Claude.ai](https://developer.tyms.io/mcp/clients/claude-ai.md), [Claude Desktop](https://developer.tyms.io/mcp/clients/claude-desktop.md), [Claude Code](https://developer.tyms.io/mcp/clients/claude-code.md), [ChatGPT](https://developer.tyms.io/mcp/clients/chatgpt.md), or [Perplexity](https://developer.tyms.io/mcp/clients/perplexity.md).

**3. 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](https://developer.tyms.io/mcp/authentication.md).

**4. Approve access in Tyms**

Sign in, choose the business, and finish OAuth. Then enable the Tyms connector in a chat and start asking questions.

## Connection details (quick reference)

| Field | Value |
| - | - |
| **Server URL (read-only)** | `https://mcp.tyms.io` |
| **Server URL (read + write)** | `https://mcp.tyms.io/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` |

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.

## Where to go next

> **[Endpoints](https://developer.tyms.io/mcp/endpoints.md)**
>
> Read-only vs full URLs and when to use each.

> **[Authentication](https://developer.tyms.io/mcp/authentication.md)**
>
> How OAuth works and which Client ID to use.

> **[Supported clients](https://developer.tyms.io/mcp/clients/claude-ai.md)**
>
> Step-by-step setup for Claude, ChatGPT, Perplexity, and more.

> **[What MCP can do](https://developer.tyms.io/mcp/capabilities.md)**
>
> Tools by domain — accounts, invoices, reports, and more.


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