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:get_time_off_balances, which answers
with every policy you are assigned to:
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 thepreview_time_off tool, without booking it:
200), a JSON-RPC result whose content[0].text is the tool’s output as JSON:
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
backHow 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 asAuthorization: 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.Related
- Setup: per-client configuration, API keys, and fixes when it fails.
- Tools: every tool’s parameters and the
tools/listcatalog. - Claude connector: add A-Char to Claude on the web, desktop and phone.
- Authentication: API keys and scopes.