What is build-error-adapter?

A workflow for creating error adapters for Arcade integrations. An error adapter translates provider or network failures into standard errors that the rest of the system can understand.

Use it when adding a provider integration, mapping SDK exceptions, or extending HTTP, GraphQL, or authentication error handling in Arcade TDK.

It makes failures more consistent, so the system can distinguish retryable problems, rate limits, missing user input, coding errors, and connection failures.

How ArcadeAI/arcade-mcp configures Claude Code

About the project

arcade-mcp is a Python framework for creating Model Context Protocol servers and the tools they expose to AI agents. Developers use it to connect agents to internal APIs, custom authentication providers, and specialized services, with support for authorization, evaluation, and deployment. The catalogue entries provide rules, skills, and integrations for working with this framework.

ArcadeAI/arcade-mcp · 1,020 stars · on GitHub · docs.arcade.dev

Reuse

Borrowing it

Nothing to install: this file belongs to ArcadeAI/arcade-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/ArcadeAI/arcade-mcp/main/.claude/skills/build-error-adapter/SKILL.md

Clone the repo

git clone --depth 1 https://github.com/ArcadeAI/arcade-mcp

Made for: Claude Code.

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/arcadeai/arcade-mcp/build-error-adapter.svg)](https://agentmods.dev/skills/arcadeai/arcade-mcp/build-error-adapter)

Your own site

<a href="https://agentmods.dev/skills/arcadeai/arcade-mcp/build-error-adapter"><img src="https://agentmods.dev/badge/skills/arcadeai/arcade-mcp/build-error-adapter.svg" alt="Measured on agentmods" height="20"></a>

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

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

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits

NVIDIA SkillSpector pass 7 Sept 2026

How audits are shown

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.00039	$0.01773
Opus 5	$0.00019	$0.00886
Sonnet 5	$0.00008	$0.00355
Haiku 4.5	$0.00004	$0.00177

Measured 8d ago against content hash 86690f706aab, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

build-error-adapter 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 8d 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.

.claude/skills/build-error-adapter/SKILL.md · 201 lines

How it starts

The opening of the file, as written. The whole thing — 201 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Build Error Adapter

Use this workflow to create new error adapters that fit Arcade TDK conventions.

Official Reference

Start here and align behavior with this doc:

Arcade docs: Providing useful tool errors (Error adapters)

Quick Context

Adapter protocol: arcade_tdk.error_adapters.base.ErrorAdapter
Common error classes:
- arcade_tdk.errors.UpstreamError — upstream responded with an HTTP status code
- arcade_tdk.errors.UpstreamRateLimitError — 429 / quota-exhausted with retry_after_ms
- arcade_tdk.errors.NetworkTransportError — no complete response was received (timeouts, connection/DNS/TLS failures, decoding errors, redirect exhaustion). status_code is always None; use one of the NETWORK_TRANSPORT_RUNTIME_* kinds: _TIMEOUT, _UNREACHABLE, _UNMAPPED.
- arcade_tdk.errors.FatalToolError — unrecoverable tool-authoring bug or environment misconfiguration (invalid URL, unsupported protocol, bad headers, TLS trust failures). Never retried.
- arcade_tdk.errors.RetryableToolError — transient tool-body failure with a hint for the LLM to retry.
- arcade_tdk.errors.ContextRequiredToolError — needs human input before retry.

Rules To Follow

Keep imports at top-level only (no inline imports), except optional dependency imports that must be lazy by design.
Adapter interface contract:
- slug class attribute
- from_exception(self, exc: Exception) -> ToolRuntimeError | None
Return None when the exception is not recognized for that adapter.
Return a ToolRuntimeError subclass for recognized exceptions (UpstreamError, UpstreamRateLimitError, etc.).
Preserve privacy:
- Agent-facing message must be safe.
- Put raw vendor detail into developer_message when needed.
Add tests for every new mapping path.
Match your installed Arcade version's decorator API and parameter names.

Read the full file on GitHub · 201 lines

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.

8d ago First seen · 201 lines · 39 tokens per session scan A 86690f706aab

Subscribe to this mod's changes

build-error-adapter is a skill published in the GitHub repository ArcadeAI/arcade-mcp (1,020 stars, last pushed 3d ago), licensed MIT. It adds 39 tokens to every session and 1,773 once invoked, about $0.0002 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.

Backend and APIs Debugging ai arcade arcade-ai mcp mcp-servers mcp-tools

printing-press-amend

Amend a published CLI from one of two input sources: (1) dogfood mode mines the active Claude Code session transcript for friction (missing flags, hand- rolled API payloads, silent-null returns); (2) direct-input mode accepts user-supplied asks (rename a command, add commands or feeds, fix a named bug, optionally…

mvanhorn/cli-printing-press · 222 tokens

convex-performance-audit

Audits Convex performance for reads, subscriptions, write contention, and function limits. Use for slow features, insights findings, OCC conflicts, or read amplification.

openclaw/clawhub · 38 tokens

convex-insights

Query a running Convex app's logs + health in natural language (official MCP): failures, slow/expensive functions, deploy causality — scoped, evidence-backed, with a dashboard deep link.

openclaw/clawhub · 45 tokens

ssl-proxy-troubleshoot

Systematic workflow for troubleshooting SSL/proxy connectivity issues with government websites.

HKUDS/OpenSpace · 20 tokens

diagnose-backend-bug

Diagnose a bounded backend or multi-service failure from GitHub Issues, Jira, Aone, user-provided exports, logs, traces, responses, stack traces, or job records. Use when a service, API, RPC, worker, queue, CLI, or scheduled job bug needs correlation through the project's existing observability route before repair; do…

QoderAI/better-harness · 87 tokens

platform-apex-anonymous-run

Use this skill to run anonymous Apex against the connected Salesforce org — from a .apex file or a pasted snippet — capturing the debug log, surfacing compile and runtime errors, and summarizing results. Trigger on phrases like "run this anonymous apex", "execute this script against my org", "run this snippet of…

forcedotcom/sf-skills · 159 tokens

arcade-mcp: Skill for Claude Code