convez.ai
MCP ServerIntegração & APIsIntermediário
Shaharamir

Grow Payments MCP — Base de Conhecimento para IA

Shaharamir/grow-payments-mcp

Documentação do Grow/Meshulam como MCP + llms.txt para agentes de IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe a documentação completa da API Light do Grow/Meshulam (gateway de pagamentos israelense) em formato pronto para LLMs. Inclui 100 páginas de docs, 25 endpoints com schemas OpenAPI, guias de integração e suporte bilíngue (inglês + hebraico). Projetado para Claude, Cursor e agentes de IA que precisam integrar pagamentos sem depender de crawling de SPA.

Instalação

$npx convez-ai Shaharamir/grow-payments-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 semana
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Integrar pagamentos Grow/Meshulam via Claude/Cursor sem consultar docs oficiais
  • Treinar agentes de IA com conhecimento estruturado de APIs de pagamento
  • Gerar código de integração para hosted payment pages e token payments

Veredito

Solução técnica sólida para developers que trabalham com Grow/Meshulam — transforma docs SPAs em corpus estruturado e queryável. Ressalva: é unofficial e não-afiliado; recomenda-se validar schemas contra docs oficiais em produção.

README

A tradução para o português deste README ainda está na fila.

Grow Payments — LLM-ready API knowledge base (llms.txt + MCP)

Grow (formerly & still widely known as Meshulam) · גרואו · משולם

🌐 Bilingual content — English & Hebrew (עברית)  ·  🇮🇱 Israeli payment gateway

License: MIT Docs: 100 pages Light API: 16 endpoints MCP server llms.txt Last commit

⚠️ UNOFFICIAL — WE ARE NOT GROW / Meshulam. Not affiliated. Not endorsed.

בסיס ידע לא רשמי לתיעוד המפתחים של Grow / משולם — מותאם ל‑LLM: קורפוס llms.txt ושרת MCP. התוכן דו‑לשוני (אנגלית + עברית). זהו פרויקט עצמאי — איננו Grow / משולם ואיננו מסונפים אליהם.


Unofficial, LLM-ready knowledge base of the Grow Payments (Meshulam / grow.link) developer documentation — the complete Light API reference, OpenAPI schemas, integration guides and changelog, packaged as an llms.txt corpus and a Model Context Protocol (MCP) server.

Built for developers and AI agents (Claude, Cursor, etc.) that need accurate, grep-able answers about Grow / Meshulam payment integration without crawling a JavaScript documentation site every time. The original docs — and therefore much of this corpus — are written in a mix of English and Hebrew (עברית).

Naming: Grow and Meshulam (Hebrew גרואו / משולם) are the same payment provider — Meshulam rebranded to Grow. People search both; this repo covers the Grow / Meshulam Light API.


Why

The official docs at grow-il.readme.io are a client-rendered SPA — hard for LLMs and scripts to consume, and mixed English/Hebrew. This repo turns the entire site into:

  • 📄 data/llms.txt — a clean, grouped index of every page (the llms.txt standard).
  • 📚 data/llms-full.txt — the whole documentation set in one ~310 KB file.
  • 🗂️ data/pages/**.md — one Markdown file per page (guides + API reference).
  • 🔌 data/openapi/*.json — OpenAPI 3.0 schema for each API endpoint.
  • 🧩 data/openapi/_grow-payments-light-api.openapi.json + Postman collection — the whole Light API (16 endpoints) merged into one importable spec.
  • 🤖 skills/grow-payments-mcp — an MCP server exposing it all as search tools.

What's inside

Count
Documentation pages100
Integration guides10
API reference pages84
API endpoints with OpenAPI schemas25
Changelog entries5

Covers: hosted payment pages, the Light Server REST API (regular & token payments, payment links, refunds, direct debit, transaction & payment-process info), webhooks / server-to-server callbacks, 3DS, NFC, POS devices, and the Apple / Bit SDKs.

.
├── data/                       # the corpus (single source of truth)
│   ├── llms.txt                #   grouped index  (start here)
│   ├── llms-full.txt           #   everything, one file
│   ├── index.json              #   machine-readable index
│   ├── pages/{home,docs,reference,changelog}/*.md
│   ├── openapi/*.json          #   per-endpoint OpenAPI 3.0  (+ _…light-api.openapi.json merged)
│   └── postman/*.json          #   Postman collection for the whole Light API
├── skills/
│   ├── grow-payments-docs/     #   llms.txt skill  (read files directly)
│   └── grow-payments-mcp/      #   MCP server      (search via tools)
└── tools/                      # reproducible scraper (scrape.sh, extract.py, build_corpus.py)

Quick start

Option A — just read it (no install)

Point your LLM / agent / script at data/llms.txt and open the pages it links to. For example:

git clone https://github.com/Shaharamir/grow-payments-mcp.git
cd grow-payments-mcp
grep -rIl -i "refund" data/pages        # find pages
cat data/pages/reference/post_api-light-server-1-0-refundtransaction-1.md

Option B — MCP server (search tools for Claude / any MCP client)

Requires Python ≥ 3.10.

python3 -m venv .venv
.venv/bin/pip install -r skills/grow-payments-mcp/requirements.txt
.venv/bin/python skills/grow-payments-mcp/selftest.py     # offline smoke test

Register with your MCP client (copy .mcp.json.example → .mcp.json and set absolute paths):

{
  "mcpServers": {
    "grow-payments-docs": {
      "command": "/abs/path/grow-payments-mcp/.venv/bin/python",
      "args": ["/abs/path/grow-payments-mcp/skills/grow-payments-mcp/server.py"],
      "env": { "GROW_DOCS_DATA": "/abs/path/grow-payments-mcp/data" }
    }
  }
}

Tools: search_docs, get_doc, list_docs, list_endpoints, get_openapi. Resources: grow://llms.txt, grow://llms-full.txt, grow://openapi.json.

Option C — import the whole API

One merged OpenAPI 3.0 spec + a Postman collection for all 16 Light API endpoints:

Example prompt once connected: "Using grow-payments-docs, show the request fields for createPaymentProcess and the refund endpoint's OpenAPI schema."


Grow API cheat-sheet

  • Endpoints: server → /api/light/server/1.0/...; Android/POS → /api/light/andriod/1.0/... (vendor spelling).
  • Sandbox host: https://sandbox.meshulam.co.il (alias https://sandboxapi.grow.link). Production hosts are issued by Grow support.
  • Auth: per-business userId + pageCode (and/or API key). Values shown in the docs are examples only.
  • Calls are server-to-server, usually multipart/form-data; client-side requests are blocked.

Keeping it fresh

The corpus is regenerated from the live site (ReadMe.io embeds page content + OpenAPI in a ssr-props JSON blob, which the scraper parses):

python3 -m pip install markdownify beautifulsoup4
./tools/scrape.sh            # incremental;  FORCE=1 ./tools/scrape.sh  re-downloads all

⚠️ Disclaimer — this is NOT official

We are not Grow Payments / Meshulam. This is an independent, community-made, unofficial mirror. It is not affiliated with, authorized by, sponsored by, or endorsed by Grow Payments, Meshulam, or grow.link in any way.

All product names, trademarks, logos and brands — including the Grow logo shown above — are the property of their respective owners and are used here purely to identify the documentation this project mirrors (nominative use), not to imply any affiliation.

Documentation content under data/ is © Grow Payments and reproduced here for developer convenience; the repository code is MIT-licensed (see LICENSE). Always verify money- or security-critical details against the official docs or Grow support before using in production. Rights holders: open an issue and any content will be amended or removed promptly.

בעברית: זהו פרויקט לא רשמי ועצמאי. איננו Grow / משולם ואיננו מסונפים אליהם, מורשים או נתמכים על ידם. כל הסימנים המסחריים והלוגו שייכים לבעליהם. לבעלי הזכויות: פתחו issue ונסיר/נתקן כל תוכן לפי בקשה.

Snapshot: 2026-06-15.

Ver o original no GitHub

Bom para

Relacionados