Skip to main content
Consile is a standard remote MCP server. If you use Claude or ChatGPT, you don’t need anything in this section. Follow Connect Claude. This section is for those who want to connect their own MCP client or build on the tools programmatically.

​
The short overview

Transport

Streamable HTTP (MCP). One endpoint for both JSON-RPC and server→client streaming.

Authentication

OAuth 2.1, discovered via RFC 9728. Your access token determines which account and which connectors you can reach.

Tools

You only get the tools your account is subscribed to. Some connectors (Search Console, Uniconta, Dinero) are read-only; others (e-conomic, Shopify, HubSpot CMS, HubSpot Marketing Email, LinkedIn Ads, Meta Ads) are read + guardrailed write. See Write tools & guardrails.

Hosting

Hosted in the EU. The connector never sees a token your client sent.

​
Endpoints

Each connector is its own named MCP at its own URL; the aggregate /mcp is the Consile Concierge (management tools only, no raw connector tools). Your URLs are shown in the portal under Konto.
The method table is the same on every endpoint (<base> = a connector URL or /mcp): Any other method returns 405 with Allow: GET, POST.
Tenancy comes solely from your access token, never from the URL or from tool arguments. A connector endpoint serves ONLY that connector’s tools; calling top_queries against /mcp (the Concierge) will not reach Search Console. Your access is re-checked on every call. Tools are namespaced as <id>__<tool> in the transport (e.g. uniconta__get_account_balance, meta-ads__create_campaign); the AI resolves these automatically.
Connector ids match ^[a-z0-9-]+$, and a few path segments are reserved (mcp, .well-known, connect, api, billing), which is why /mcp is the Concierge, not a connector.

​
What this section covers

Connect an MCP client

From a custom client or via an SDK / mcp-remote.

Authentication

The OAuth flow at the protocol level: discovery, token, scopes.

Write tools & guardrails

How the write-capable connectors behave: WritePreview dry-runs, the confirm:true contract, and the PAUSED/DRAFT defaults.

API reference: Google Search Console

All seven read-only tools with parameters and examples.

API reference: Uniconta

The 19 read-only accounting tools (debtors, creditors, G/L, inventory, query).

API reference: e-conomic

27 tools: 23 read, 4 guardrailed write (customers + draft invoices).

API reference: Dinero

The 52 read-only tools (accounts, invoices, contacts, vouchers, reports).

API reference: Shopify

All 50 tools: 40 read, 10 guardrailed write (products, publishing, inventory).

API reference: HubSpot CMS

23 tools: 14 read, 9 guardrailed write (pages, blog, HubDB).

API reference: HubSpot Marketing Email

19 tools: 8 read, 11 guardrailed write (drafts free; sending is confirm-gated).

API reference: Meta Ads

All 39 tools: 34 read, 5 guardrailed write (read + guardrailed write).

API reference: LinkedIn Ads

All 64 tools: 45 read, 19 guardrailed write (read + guardrailed write).

API reference: Concierge

The management tools on /mcp.

Errors & limits

JSON-RPC errors, row limits, data freshness.