Wathba

io.github.wathba-orgv2.0.1更新於 Oct 1, 2026

Saudi payments, OTP/SMS, KYC, ZATCA e-invoicing and shipping for AI coding agents.

已驗證Streamable HTTP可網頁執行Developer ToolsBusiness & Commerce

概覽

AI 產生的概覽

將 AI 程式開發代理連接到 Wathba 代管的 MCP 伺服器，用於沙烏地付款、OTP/簡訊、KYC、ZATCA 電子發票與物流。

功能
Wathba 是官方外掛，將 AI 程式開發代理連接到 Wathba 代管的 MCP 伺服器（R2、R3）。透過它，助理可以使用 Wathba 的付款、OTP/簡訊、KYC、ZATCA 電子發票與物流服務（R4）。外掛也會加入一段簡短技能說明，告訴代理如何使用該伺服器（R3），伺服器提供的工具清單記錄在 contract.json 中（R40）。
適用情境
當你正在開發或維運需要沙烏地市場服務的應用（例如付款、OTP/簡訊驗證、KYC、ZATCA 電子發票或物流），並希望 AI 程式開發代理直接呼叫這些服務時使用（D1、R4）。它適合已採用 Wathba 作為服務商的團隊，而非一般代理工作。若不需要這些服務或沒有 Wathba 帳號，則不必安裝。
執行需求
需要連線到遠端 Streamable HTTP MCP 伺服器：正式環境為 API 金鑰或環境變數；成員透過瀏覽器 OAuth 登入（R4、R10、R14）。支援 Claude Code、Codex、ChatGPT 桌面應用程式、Claude 網頁版/桌面版/Cowork 及其他 MCP 用戶端（R3、R18）。需要能連線到 Wathba 端點的網路。
安裝前請注意
每個連線都會取得對 Wathba 帳號的完整代理存取權，同意頁面會顯示這代表允許哪些操作（R32），核准前請先確認。外掛本身不處理 API 金鑰，登入是透過瀏覽器 OAuth 完成（R4），但相關工具可能發起付款、傳送 OTP/簡訊、提交 KYC 資料、開立 ZATCA 電子發票與安排物流，因此操作可能涉及金流或將資料送往第三方。請只使用外掛或直連其中一種，否則每個工具都會出現兩次（R19）。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Wathba，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "wathba": {
      "type": "http",
      "url": "https://api.wathba.info/mcp"
    }
  }
}

README

Wathba agent plugin

The official Wathba (وثبة) plugin for AI coding agents. It connects Codex, the ChatGPT desktop app, Claude Code and other Agent Plugins clients to Wathba's hosted MCP server, and adds one short skill that tells the agent how to use it. Payments, OTP/SMS, KYC, ZATCA e-invoicing and shipping reach your app through Wathba; the plugin never handles API keys, and members sign in through the browser (OAuth).

EnvironmentBranchInstall idMCP server
Productionmainwathba@wathbahttps://api.wathba.info/mcp
Developmentdevwathba-dev@wathba-developmenthttps://apidev.wathba.info/mcp

Install

Claude Code

text
/plugin marketplace add wathba-org/wathba-plugin/plugin install wathba@wathba

For the development environment, add wathba-org/wathba-plugin#dev and install wathba-dev@wathba-development. Then run /mcp, choose the Wathba server and sign in. To get updates automatically, open /plugin, go to Marketplaces, select the marketplace and choose Enable auto-update.

Codex and the ChatGPT desktop app

sh
codex plugin marketplace add wathba-org/wathba-plugincodex plugin add wathba@wathba

For the development environment, add --ref dev and install wathba-dev@wathba-development. Installing from the app's Plugins page starts sign-in; in a terminal, run codex mcp login wathba (or wathba-dev). Codex checks the marketplace for updates when it starts.

Any other MCP client

Add the remote MCP server URL from the table above with the Streamable HTTP transport; the client discovers Wathba's OAuth settings on its own. Claude (web, Desktop and Cowork) and ChatGPT take it as a custom connector. Use either the plugin or a direct connection, not both, or every Wathba tool appears twice.

How this repository works

Nothing under plugins/, .claude-plugin/, .agents/ or contract.json is edited by hand. They are generated from two sources:

  • plugin.config.json: identities, origins, version, branding and listing text.
  • src/: the shared skill (src/skills/wathba/SKILL.md), the icon, and the README for the dev branch.

scripts/sync.mjs builds one marketplace per environment and enforces the packaging rules: identities, paths, one MCP server per package with no headers or scopes, environment isolation, no credentials, the skill's tool list, and the icon hash.

WorkflowWhenWhat it does
validateEvery PR, push to main, weeklyGenerator rules, version rule, then installs both builds into throwaway Claude Code and Codex homes, then checks the live OAuth metadata
publish-devPush to mainBuilds the development marketplace, verifies it, and publishes it to the dev branch
driftDailyChecks both environments' live OAuth metadata and opens an issue when it stops matching
releasev* tag on mainGitHub release with the plugin ZIP, then the MCP Registry entry

The packages carry no scopes. The Wathba server decides the grant: every connection gets full agent access, and the consent page shows exactly what that allows.

Change the plugin

  1. Edit plugin.config.json or src/.
  2. Run node scripts/sync.mjs check.
  3. If the production package changes, raise version in plugin.config.json. CI refuses a changed package with the same version, because Claude Code updates only when the version changes.
  4. Open a pull request. Every change here reaches members' agents, so the owner's review is required.

contract.json lists the Wathba tools the skill names. The platform's CI reads it and fails a backend change that would remove or rename one of them.

Release production

  1. Merge the change (with its higher version) to main. Plugin installs pick it up from main.
  2. Tag the merge commit v<version> and push the tag. release.yml checks that the tag, config and package agree, attaches the plugin ZIP, server.json and checksums to a GitHub release, then publishes server.json to the official MCP Registry after the owner approves the registry environment.

listing/ holds the material for the Anthropic and OpenAI directories.

Acceptance

docs/acceptance/ records the real host journeys (sign-in, reads, project creation, replay, recovery, update, rollback). A host is listed as supported only after a recorded run.

License

Apache-2.0

來源：README.md，提交 a14db87

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v2.0.1最新Oct 1, 2026