Skip to content
Back to search

SyrianFatora-MCP

Secure remote MCP server for SyrianFatora API with OAuth 2.1 authorization and Cloudflare Workers deployment.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 18 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/kenanwahbeh/SyrianFatora-MCP with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/kenanwahbeh/SyrianFatora-MCP'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kenanwahbeh--syrianfatora-mcp/badge.svg)](/listings/kenanwahbeh--syrianfatora-mcp)

HTML

<a href="/listings/kenanwahbeh--syrianfatora-mcp"><img src="/api/listings/kenanwahbeh--syrianfatora-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 62 lines
  1. # SyrianFatora MCP
  2. Secure remote Model Context Protocol (MCP) gateway for the SyrianFatora public API, hosted on Cloudflare Workers.
  3. > **Project direction (2026-11-18):** Migrate the existing production MCP service in place. Keep the production Worker name `syrianfatora-mcp`, preserve its MCP endpoint identity and the existing 51 tools, and add OAuth 2.1 authorization. The MCP resource Worker remains the same service; a separate `syrianfatora-auth` Worker is required as the authorization server and connects to it through a Cloudflare Service Binding. Do not create a replacement MCP service.
  4. ## Product goal
  5. Let a user connect their SyrianFatora workspace to ChatGPT or another compatible MCP client, then manage and read permitted billing resources through the existing MCP tool catalogue. Users must enter their SyrianFatora API key only on the first-party HTTPS authorization page; the key must never be pasted into chat, sent to the MCP client, or stored in a plugin package.
  6. ## Current status
  7. - OAuth authorization and MCP resource-server source code are already merged into `main`.
  8. - The MCP package preserves the existing 51 tools and enforces `mcp:read` / `mcp:write`.
  9. - Both packages have previously built successfully and their unit tests passed in CI. **The user has instructed that automated tests be deferred for the immediate production migration; this is not a claim that end-to-end OAuth has been tested.**
  10. - Local Worker-runtime integration and complete OAuth flow verification remain outstanding.
  11. - Production currently remains on the previously inspected legacy `1.1.0` Worker baseline. The OAuth code is not yet active in production.
  12. - The first production build attempt failed at deploy because the local config name `syrianfatora-mcp-oauth-preview` conflicted with the Cloudflare CI target `syrianfatora-mcp`; Cloudflare warned that the live script had been updated through the script API and aborted without applying the upload. Do not bypass this with an unreviewed `--force`.
  13. ## Agreed production architecture
  14. - **Existing resource Worker:** `syrianfatora-mcp` — keep this exact production service name; migrate its code in place.
  15. - **Authorization Worker:** `syrianfatora-auth` — separate OAuth 2.1 authorization server, required by the Workers OAuth Provider v1 split architecture.
  16. - **Internal connection:** Cloudflare Service Binding from `syrianfatora-mcp` to the `SyrianFatoraAuth` entrypoint exported by `syrianfatora-auth`.
  17. - **OAuth:** Authorization Code + PKCE; scopes `mcp:read` and `mcp:write`; `offline_access` only if the client lifecycle requires it.
  18. - **Credential isolation:** provider-encrypted authorization `props`; never expose the upstream key to the client or create a plaintext credential record.
  19. - **Compatibility:** preserve the existing 51 MCP tool names and their SyrianFatora API semantics.
  20. ## Production migration rules
  21. 1. Keep the existing `syrianfatora-mcp` Worker name and production identity.
  22. 2. Do not create a second MCP resource Worker as a replacement.
  23. 3. Create the separate authorization Worker only as the OAuth architecture dependency.
  24. 4. Determine and record the real production Worker URLs, account Worker subdomain, and KV namespace ID from Cloudflare. Never invent URLs or IDs and never deploy `.invalid` placeholders.
  25. 5. Configure the auth Worker, KV binding, MCP public resource URL, auth issuer URL, and Service Binding consistently.
  26. 6. Preserve a rollback path to the exact current production script/version before replacing the live MCP script.
  27. 7. Do not use `--force` to silence a script-API conflict until the live baseline is captured and the exact overwrite is understood.
  28. 8. Automated tests are deferred for this immediate migration at the user's direction. Record this as a testing exception, not a passing result. Do not run destructive/write smoke tests against a real SyrianFatora workspace.
  29. 9. Record every Cloudflare resource created or changed, deployment/version ID, probe result, and rollback reference in [the production migration log](docs/production-migration.md).
  30. 10. Never put API keys, OAuth tokens, signing keys, KV secrets, or Cloudflare credentials in Git, issues, logs, or chat.
  31. ## Project documents
  32. - [Architecture](docs/architecture.md)
  33. - [Security model](docs/security.md)
  34. - [Implementation plan and acceptance criteria](docs/implementation-plan.md)
  35. - [Production migration runbook and log](docs/production-migration.md)
  36. - [Architecture decisions](docs/adr/)
  37. - [Contributing](CONTRIBUTING.md)
  38. - [Security policy](SECURITY.md)
  39. ## Development
  40. - MCP Worker: `cd apps/mcp && npm run build:check && npm test`.
  41. - Authorization Worker: `cd apps/auth && npm run build:check && npm test`.
  42. - Build checks use Cloudflare `cf build`; they do not deploy.
  43. - Automated tests are currently deferred for the immediate production migration by explicit user direction. Restore the test gate before subsequent feature releases.
  44. - Never use a production workspace for write-operation tests.
  45. ## License
  46. This project is licensed under the [MIT License](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.