oezdempanel (Agent Plugin v0.2.0)

Read-only Cursor Agent Plugin for ÖzdemPanel Public API Read v1: MCP tools for health, tahsilat sözleri, cari, BU reports, actions, and fleet live.

What it does

Tool	Endpoint	Scope
`health`	`GET /api/health`	none
`list_promises`	`GET /api/public/promises`	`read:promises` or `read:all`
`cari_summary`	`GET /api/public/cari/summary`	`read:cari` or `read:all`
`cari_rows`	`GET /api/public/cari/rows`	`read:cari` or `read:all`
`list_bu_reports`	`GET /api/public/bu-reports`	`read:bu-reports` or `read:all`
`list_actions`	`GET /api/public/actions`	`read:actions` or `read:all`
`fleet_live`	`GET /api/public/fleet/live`	`read:fleet` or `read:all`

list_promises: optional bu, status (PENDING|KEPT|MISSED|CANCELLED). Domain: PromiseToPay = { id, buSlug, musteriKodu, amount, dueDate, status }.
Read v1 five (cari_summary, cari_rows, list_bu_reports, list_actions, fleet_live): bu required (marka / business-unit slug).
- cari_rows also: limit?, includeVirtual? (bool→1), overdueOnly? (bool→1), minBakiye?
- list_bu_reports also: kind?, limit?
- list_actions also: status? (CSV string; omit for API default)

This plugin is read-only. It does not wrap Report Hub writes or cookie-only routes.

Marka (BU) rules

Pass bu as the marka slug (e.g. redbull, tuborg).
Token may be bound to a business unit; requesting another marka → 403.
Missing bu on the five Read v1 tools → tool error (and API would return 400 bu zorunlu).
read:all covers all read:* scopes; it does not grant write:*.

Environment

Variable	Required	Description
`OEZDEMPANEL_API_TOKEN`	Yes for all tools except `health`	Panel API token
`OEZDEMPANEL_BASE_URL`	No	Defaults to `https://cagandogru.com`

Token

Panel → Ayarlar → API Token, with scopes as needed: read:promises, read:cari, read:bu-reports, read:actions, read:fleet, or read:all.

Local install (Cursor IDE)

Copy into a real directory (not a symlink pointing outside the plugins tree):

rm -rf ~/.cursor/plugins/local/oezdempanel
mkdir -p ~/.cursor/plugins/local
cp -a /path/to/oezdempanel ~/.cursor/plugins/local/oezdempanel

Restart Cursor / reload plugins so mcp.json is picked up. Set env vars in Cursor MCP / shell environment as needed.

Note: Grok Bot loads marketplace plugins only. Local install is for Cursor IDE prove/use.

Smoke

# health — no token
curl -sS "${OEZDEMPANEL_BASE_URL:-https://cagandogru.com}/api/health"

# Read v1 (needs token + bu)
# curl -sS -H "Authorization: Bearer $OEZDEMPANEL_API_TOKEN" \
#   "${OEZDEMPANEL_BASE_URL:-https://cagandogru.com}/api/public/cari/summary?bu=YOUR_BU"

Files

plugin.json — Agent Plugins 1.0.0 manifest
mcp.json — stdio MCP server wiring (server.mjs)
server.mjs — zero-dep Node MCP (NDJSON + Content-Length framing)
skills/oezdempanel/SKILL.md — agent skill guidance

License

MIT