A setup and troubleshooting guide for connecting the Well MCP, a tool service that coding agents can use to work with Well data. It covers authentication and checking that the connection responds.

Use it after installing the Well plugin, when Well tools are missing or unresponsive, or when you need to verify access to Well data types.

It removes uncertainty after installing the Well plugin or when its tools do not appear to work. It explains the required browser sign-in and how to confirm the connection is live.

connect — Skill for Claude Code and Codex by WellApp-ai: A setup and troubleshooting guide for connecting the Well…

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add skills/wellapp-ai/well/connect

Any agent

npx skills add WellApp-ai/Well --skill connect

Clone the repo

git clone --depth 1 https://github.com/WellApp-ai/Well

Made for: Claude Code, Codex.

Or install well, the plugin that ships this one along with the rest of its 9 skills, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/wellapp-ai/well/connect.svg)](https://agentmods.dev/skills/wellapp-ai/well/connect)

Your own site

<a href="https://agentmods.dev/skills/wellapp-ai/well/connect"><img src="https://agentmods.dev/badge/skills/wellapp-ai/well/connect.svg" alt="Measured on agentmods" height="20"></a>

Per session 55 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 530 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00055	$0.00530
Opus 5	$0.00028	$0.00265
Sonnet 5	$0.00011	$0.00106
Haiku 4.5	$0.00006	$0.00053

Measured 6d ago against content hash eb7d7216d782, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

connect scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/well/skills/connect/SKILL.md · 45 lines

What it actually says

Connect to Well

Run this right after installing the Well plugin, or whenever the Well tools aren't responding. Walk the user through it conversationally — do not dump all steps at once if a step is already done.

1. Confirm the MCP server is registered

Installing the plugin auto-adds the well MCP server (it is bundled in the plugin manifest). If the user just installed it, make sure it's active:

Tell them to run /reload-plugins if they haven't since installing.
The server should now appear when they run /mcp.

The Well MCP uses OAuth, so the first connection needs a one-time sign-in:

Run /mcp, select well, and choose Authenticate. A browser opens — sign in to your Well account and approve. No API key, no config.

If /mcp shows well as already authenticated, skip this.

3. Verify it works

Call well_get_schema (no arguments) to confirm the connection is live. If it returns the list of roots (companies, invoices, transactions, ledger_accounts, …), the connection is working — tell the user "Connected ✓, N data types available."

If it returns an auth error, send them back to step 2. If it returns a server error on the heavy roots, the connection is fine but the workspace data path may be temporarily unavailable — say so rather than implying the setup failed.

4. Show what to ask

Once connected, offer 3 concrete starting prompts so the user gets value immediately:

"Summarize last month's cash flow"
"List my unpaid invoices over €5,000"
"Build my compte de résultat for the last quarter"

Mention the deeper skills are available too: /well:reconciliation, /well:vat-summary, /well:ar-aging, /well:month-end-close, /well:compte-de-resultat, /well:balance-sheet, /well:cash-flow-forecast.

Note on billing

Tool calls use Well credits, billed to the workspace plan. Mention this once if the user asks about cost — do not interrupt every call.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

6d ago First seen · 45 lines · 55 tokens per session scan A eb7d7216d782

Subscribe to this mod's changes

connect is a skill published in the GitHub repository WellApp-ai/Well (340 stars, last pushed 29d ago), licensed MIT. It adds 55 tokens to every session and 530 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Building agents ai api automation finops invoice invoice-extraction

auto-reader-ocr

Extract text from images/PDFs (Arabic-first, manga-aware Japanese, 13+ languages auto-detected), translate between 100+ languages, and pull structured fields from invoices/receipts/IDs via the Auto-Reader OCR API. Use when the user shares a document image or PDF to read, translate, or extract data from — or asks for…

Samqra/auto-reader-ocr · 101 tokens

ccxt-rust

CCXT cryptocurrency exchange library for Rust developers. Covers both REST API (standard) and WebSocket API (real-time). Helps install CCXT, connect to exchanges, fetch market data, place orders, stream live tickers/orderbooks, handle authentication, and manage errors in Rust projects. Use when working with crypto…

ccxt/ccxt · 96 tokens

nextjs-pages-router

Set up tRPC in Next.js Pages Router with createNextApiHandler, createTRPCNext, withTRPC HOC, SSR via ssr option and ssrPrepass, SSG via createServerSideHelpers with getStaticProps, and server-side helpers for getServerSideProps prefetching.

trpc/trpc · 67 tokens

non-json-content-types

Handle FormData, file uploads, Blob, Uint8Array, and ReadableStream inputs in tRPC mutations. Use octetInputParser from @trpc/server/http for binary data. Route non-JSON requests with splitLink and isNonJsonSerializable() from @trpc/client. FormData and binary inputs only work with mutations (POST).

trpc/trpc · 75 tokens

scalar-docs

Skill for writing and updating scalar.config.json — Scalar Docs configuration reference for users and LLMs.

scalar/scalar · 24 tokens

horse-integration-tests

Guide for writing automated integration tests for Horse endpoints using DUnit/DUnitX and THTTPClient.

HashLoad/horse · 25 tokens