Skip to content

Adapter: Faire (brands) #1408

Closed
Closed

Description

@helpcodeai

👋 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

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_KEY

Then 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

  1. aj-codespy commented on Nov 6, 2026

    @aj-codespy
    Contributor

    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?

  2. helpcodeai commented on Nov 6, 2026

    @helpcodeai
    ContributorAuthor

    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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions