Skip to content

docs(satellites): Write example prompts and a FAQ for the Exact Online and AFAS satellites (#995) - #1214

Merged
helpcodeai merged 3 commits into
HelpCode-ai:mainfrom
CG-5228:oss-agent/issue-995
Oct 24, 2026
Merged

helpcodeai merged 3 commits into
HelpCode-ai:mainfrom
CG-5228:oss-agent/issue-995

Conversation

@CG-5228

@CG-5228 CG-5228 commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

Closes #995

Summary

Adds hand-written English prompts.md and faq.md files for the two verified-untested NL/BE ERP satellites requested in #995:

  • scripts/satellites/content/exact-online-mcp-server/prompts.md — 14 concrete prompts grounded in the 12 exact_online_* read-only OData v1 tools and the 5 built-in OData tools (list_entities, get_metadata, query, get, count).
  • scripts/satellites/content/exact-online-mcp-server/faq.md — 6 Q&As covering OAuth2 setup at apps.exactonline.nl (including region URLs for NL, BE, DE, UK), administration/division scoping, read-only OData GET guarantees, live-testing status, and ChatGPT / Copilot / Claude Code compatibility.
  • scripts/satellites/content/afas-mcp-server/prompts.md — 14 concrete prompts grounded in the 6 afas_profit_* tools (Profit_Debtor, Profit_Debtor_Invoices, Profit_Employees, list_connectors, get_connector_metadata, and get_data for custom GetConnectors).
  • scripts/satellites/content/afas-mcp-server/faq.md — 6 Q&As covering App connector setup in AFAS Profit (Algemeen -> Beheer -> App connector), custom GetConnector discovery and querying, read-only HTTP GET behavior (4 GetConnector tools and 2 /metainfo tools, with no UpdateConnectors exposed), live-testing status, and MCP client compatibility.

Verification

  • node --test scripts/satellites/satellites.test.mjs (all 18 tests pass)
  • node scripts/satellites/generate.mjs --check --only exact-online-mcp-server,afas-mcp-server (passes with zero English content warnings)

@CG-5228
CG-5228 requested a review from helpcodeai as a code owner October 23, 2026 14:40
@github-actions

Copy link
Copy Markdown

👋 Welcome, @CG-5228, and thanks for opening your first PR on AnythingMCP!

A few quick pointers:

  • Make sure CI is green before requesting review (Backend, Frontend, Playwright, CodeQL, Trivy).
  • If this is a new adapter, the parametrised catalog.spec.ts test will validate it automatically.
  • Sign off your commits if you can — it's not blocking, just nice to have.

Someone from the core team will look at this within ~48h. If you don't hear back, please ping us in Discussions / Q&A.

⭐ While you wait — if you find AnythingMCP useful, a star helps others discover it.

@github-actions

github-actions Bot commented Oct 23, 2026 •

Copy link
Copy Markdown

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@helpcodeai

Copy link
Copy Markdown
Contributor

Thanks @CG-5228, this is good work. I checked the prompts against the Exact Online and AFAS adapters and they hold up, and the FAQ matches the tone of the Xentral one.

Two small wording fixes before merge:

  1. "Which sales invoices over 5,000 EUR are still open?": in Exact an "open" sales invoice means not processed yet, not unpaid. Most readers will mean unpaid, which is what the receivables tool answers, so I'd write "still unpaid".
  2. The general ledger prompt about the "profit and loss side": exact_online_list_gl_accounts has no filter, and the P&L marker is BalanceType, not BalanceSide. Something like "List the general ledger accounts and tell me which ones are profit and loss accounts" works.

Also, the AFAS FAQ says all six tools call GetConnectors, but two of them call /metainfo. Still read-only, just a detail.

And before I can merge, please sign the CLA: post a comment with exactly "I have read the CLA Document and I hereby sign the CLA" and nothing else.

@CG-5228

CG-5228 commented Oct 23, 2026

Copy link
Copy Markdown
Contributor Author

I have read the CLA Document and I hereby sign the CLA

@CG-5228

CG-5228 commented Oct 23, 2026

Copy link
Copy Markdown
Contributor Author

Thanks for the review @helpcodeai! I have pushed ed2666f addressing all three wording points and signed the CLA above:

  1. scripts/satellites/content/exact-online-mcp-server/prompts.md:
    • Updated "Which sales invoices over 5,000 EUR are still open?" to "Which sales invoices over 5,000 EUR are still unpaid?".
    • Updated the general ledger prompt to "List the general ledger accounts and tell me which ones are profit and loss accounts.".
  2. scripts/satellites/content/afas-mcp-server/faq.md:
    • Clarified under ### Can the AI change data in AFAS Profit? that 4 tools query GetConnectors and 2 inspect /metainfo (all 6 are read-only HTTP GET requests, with no UpdateConnectors exposed).

github-actions Bot added a commit that referenced this pull request Oct 23, 2026

@helpcodeai helpcodeai left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the fixes, looks good.

@helpcodeai
helpcodeai enabled auto-merge (squash) October 24, 2026 07:46
@helpcodeai
helpcodeai merged commit f91044e into HelpCode-ai:main Oct 24, 2026
14 checks passed
@github-actions github-actions Bot locked and limited conversation to collaborators Oct 24, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Write example prompts and a FAQ for the Exact Online and AFAS satellites

2 participants