Repository navigation
Description
👋 A self-contained first contribution: one JSON adapter file, a spec and a logo. No need to know the rest of the codebase.
Why this one
In the last 30 days, 2 different workspaces on AnythingMCP Cloud searched the catalog for Faire and found nothing. People want it; nobody has built it yet.
The API
- Docs: https://faire.github.io/external-api-v2-docs/
- Auth: an access token in the
X-FAIRE-ACCESS-TOKENheader - Category: E-commerce
Suggested first tools (read-only)
list orders, get one order, list products, get inventory levels. Read-only tools are enough for a first version; write tools can follow in a later PR.
How
Follow the six steps in AGENTS.md → Add an adapter and docs/tool-definition.md. The scaffold command for this one:
npm run adapter:new -- faire --region intl --auth API_KEYThen node scripts/validate-adapters.mjs --warn, node scripts/regenerate-catalog.mjs, a intl/faire.live.spec.ts (static assertions always, live calls behind RUN_FAIRE_LIVE=1), node scripts/adapter-count.mjs --check and the logo. The walkthrough and past examples are in #982.
Done when
- The adapter validates without new warnings and the catalog is regenerated.
- Every tool has a description an AI can act on (what it returns, when to use it) and a response mapping that keeps the useful fields.
- The PR says which calls you ran against a real account, or that you could not and built it from the docs.
Claim it
Comment here to claim it. A claim without a PR for 14 days goes back to the pool, no hard feelings. Sign the CLA when the bot asks.
Activity
aj-codespy commentedon Nov 6, 2026
Hi, I'd like to take the Faire adapter, as suggested on #1418. I'll follow AGENTS.md, keep the first version read-only, and gate live calls in the spec behind an env flag like the SonarQube one (#1317). Could you assign it to me?
helpcodeai commentedon Nov 6, 2026
Great, it's yours @aj-codespy. I've assigned it to you.
Read-only first is the right start, and the env flag for live calls like in #1317 is exactly what we want. Please check the brand-side API docs for the auth Faire uses today, and keep credentials as variable references in the JSON.
Open a draft PR early if you want feedback on the tool list before you write the specs.
test(adapters): add Faire spec, logo and updated counts (HelpCode-ai#…
Quote 715 adapters after merging main (HelpCode-ai#1408)
feat(adapters): add read-only Faire adapter (#1408) (#1563)