Skip to main content
Point any MCP client at https://a-char.com/api/mcp and sign in with your A-Char account. The assistant can then check balances, book and change time off, and approve your team’s requests. The server is hosted, so there is nothing to install, and it implements the Model Context Protocol, so it works with Claude Code, Claude, Cursor, Codex, Grok Bot, VS Code and any other MCP client.

First call

Add the server to your client and sign in. In Claude Code that is 2 commands:
Then ask the assistant how much time off you have left. It calls get_time_off_balances, which answers with every policy you are assigned to:
Setup has the configuration for Claude, Cursor, VS Code, Codex and every other client.

Autonomous agents

An agent has nobody at a browser to sign in, so it sends an API key and calls the tools itself. The server speaks Streamable HTTP, so plain HTTP works. This previews a week of annual leave with the preview_time_off tool, without booking it:
Response (200), a JSON-RPC result whose content[0].text is the tool’s output as JSON:
The 24th and 25th are public holidays, so only 3 days count against the balance. Call request_time_off with the same arguments to book it. Create a dedicated key per agent so you can revoke it on its own; Setup has the rest.

Tools

9 time-off tools cover checking balances, previewing, booking, changing, cancelling and approving leave, and downloading its documents.

Setup

Config for Claude Code, Claude, Cursor, Codex, Grok Bot, VS Code and other clients, API keys, and what to do when it fails

Tools

Every tool with its parameters, the tools/list call that returns your catalog, and how errors come back

How it behaves

Sign-in or an API key

Clients that support OAuth need only the server URL: you sign in with your A-Char account and there is no key to copy. Agents, and anyone who wants to choose exactly which tools the assistant gets, send an API key as Authorization: Bearer $A_CHAR_API_KEY.

It acts as you

Every tool runs the same code as the API and the dashboard, as you, in your organization. The assistant can do exactly what you can do in A-Char and nothing more, and the usual rules still apply: a request that would overdraw a balance or overlap another one is rejected with the message you would see in A-Char.
  • Setup: per-client configuration, API keys, and fixes when it fails.
  • Tools: every tool’s parameters and the tools/list catalog.
  • Claude connector: add A-Char to Claude on the web, desktop and phone.
  • Authentication: API keys and scopes.