Agent skill

Payram Widget Integration

by PayRam in PayRam/payram-mcp

Add a PayRam "Add Credit" / tip-jar payment button to a website or web app safely.

No licenceAuto-check passedBackend & APIs

Install Payram Widget Integration

skills CLI
$ npx skills add PayRam/payram-mcp --skill payram-widget-integration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install PayRam/payram-mcp payram-widget-integration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/PayRam/payram-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/payram-widget-integration .claude/skills/payram-widget-integration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
payram-widget-integration
GitHub stars
158
Token cost
~4.5k tokens
SKILL.md length
918 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
None found

At a glance

Add a PayRam "Add Credit" / tip-jar payment button to a website or web app safely.

  • Works in 9 steps: Recommended: a backend endpoint creates… → The hosted script-tag embed (internal or… → Programmatic alternative — Node SDK… → …
  • Adding payment capability to an existing web frontend
  • SKILL.md covers 1. Recommended: a backend…, 2. The hosted script-tag embed…, 3. Programmatic alternative —… and 4. REST API (no SDK), plus 5 more sections
  • Calls curl; reaches payram.com; needs PAYRAM_API_KEY and API_KEY

What it does

Payram Widget Integration is an agent skill from PayRam/payram-mcp. Add a PayRam "Add Credit" / tip-jar payment button to a website or web app safely. Explains why the public payram-add-credit-v1.js embed exposes a payout-capable project API key and shows the recommended backend-endpoint pattern instead, lists the attributes the script actually reads, and gives signed-webhook handlers (X-Payram-Signature HMAC over the raw body) for Express, Next.js API routes, FastAPI, Laravel, and Gin, plus idempotent processing and the retry schedule (30m, 1h, 2h, 4h, 8h, 24h, 48h). Also shows…

Its SKILL.md is about 4.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Webhooks, Backend development and REST APIs. It works with FastAPI, Laravel and Next.js. The repository describes itself as: Connect to hosted payram helper at: https://mcp.payram.com.

When your agent uses it

  • Adding payment capability to an existing web frontend
  • Embedding a tip jar
  • Credit top-up flow
  • Writing the backend webhook handler that fulfils orders when a payment is FILLED

Example prompts

  • “Add Credit”
  • “/payram-widget-integration”

Requirements

  • Node.js
  • A credential in PAYRAM_API_KEY
  • A credential in API_KEY

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Recommended: a backend endpoint creates the payment
  2. The hosted script-tag embed (internal or demo pages only)
  3. Programmatic alternative — Node SDK (server-side)
  4. REST API (no SDK)
  5. Webhook payload contract
  6. Webhook handlers
  7. Idempotency pattern
  8. Common pitfalls
  9. See also

What it can do on your machine

Read from SKILL.md and the folder at commit e460a40. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • payram.com

    Also links to:

    • docs.payram.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • PAYRAM_API_KEY
    • API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Payram Widget Integration loads about 4.5k tokens when it runs. Until then it costs about 197 tokens; SKILL.md has 918 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~197
When it runs · the whole SKILL.md, loaded when a task matches
~4.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 918 words (~4,451 tokens).

“The browser sends only the amount. Your server holds the key, creates the payment and returns the hosted checkout URL.”

— opening of SKILL.md by PayRam
name
payram-widget-integration

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/payram-widget-integration of PayRam/payram-mcp.

Open the folder on GitHubat commit e460a40

Compare with similar skills

Payram Widget Integration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Payram Widget Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Payram Widget Integration this skillPayRam/payram-mcp158—~4.5kAutomated safety check: PassNone
App Buildersoftspark/ai-toolkit179—~2.2kAutomated safety check: PassApache-2.0
Htmxericrisco/rsc-harness167—~3.4kAutomated safety check: PassMIT
Fastcrudbenavlabs/fastcrud1.6k—~5kAutomated safety check: PassMIT
Laravel SpecialistJeffallan/claude-skills12k1 repos~2.1kAutomated safety check: PassMIT
Cashier Stripe Developmentluadotsh/lua3431 repos~1.2kAutomated safety check: PassMIT

Similar skills

  • App Builder

    softspark/ai-toolkit

    App scaffolding: Next.js, Vite, Nuxt, Astro, FastAPI, Django, Laravel, RN, Flutter.

    179 GitHub stars~2.2k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Htmx

    ericrisco/rsc-harness

    A skill your agent uses when adding interactivity to a server-rendered app (FastAPI/Jinja, Django, Rails, Laravel, Go templates, Express) without adopting a JS framework — hx-get/post/put/delete…

    167 GitHub stars~3.4k tokensUpdated today
    Backend & APIsAuto-check passed
  • Fastcrud

    benavlabs/fastcrud

    A skill your agent uses when building or modifying CRUD endpoints with FastCRUD (the fastcrud PyPI package) in a FastAPI project — covers FastCRUD, crudrouter, EndpointCreator, FilterConfig…

    1.6k GitHub stars~5k tokensUpdated 13 days ago
    Backend & APIsAuto-check passed
  • Laravel Specialist

    Jeffallan/claude-skills

    Builds Laravel 10+ applications with Eloquent models, Sanctum authentication, Horizon queues, API resources and Livewire components, tested with Pest or PHPUnit.

    12k GitHub starsUsed in 1 repo~2.1k tokens
    Backend & APIsAuto-check passed
  • Handles Laravel Cashier Stripe integration including subscriptions, webhooks, Stripe Checkout, invoices, charges, refunds, trials, coupons, metered billing, and payment failure handling.

    343 GitHub starsUsed in 1 repo~1.2k tokens
    Backend & APIsAuto-check passed
  • Andrej Karpathy Perspective

    nazarli-shabnam/clevis

    Andrej Karpathy的思维框架与表达方式。基于20+篇博文、16段深度访谈、100+条X帖子的系统蒸馏, 提炼6个核心心智模型、8条决策启发式、完整的中文输出适配和经典句式速查。

    170 GitHub starsUsed in 3 repos~3.8k tokens
    Backend & APIsAuto-check passed

More from PayRam/payram-mcp

All 12 skills in this repo
  • PayRam Payment Analytics

    PayRam/payram-mcp

    Queries a PayRam server's dashboard data through its REST APIs with a Bearer token: payment search, daily volume, unswept balances, sweep history and on-ramp metrics.

    158 GitHub stars~4.1k tokensUpdated yesterday
    Auto-check passed
  • Payram Auth

    PayRam/payram-mcp

    Authenticate with a PayRam instance to access merchant dashboard APIs.

    158 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • PayRam Bitcoin Payments

    PayRam/payram-mcp

    Explains accepting on-chain Bitcoin with PayRam's self-hosted setup: HD wallet deposit addresses, mobile app signing for sweeps, and the same payment API as other coins.

    158 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Adds crypto checkout to a web app with PayRam: create a payment from your backend, send the customer to the payment page, then confirm the result.

    158 GitHub stars~3.4k tokensUpdated yesterday
    Auto-check: notes
  • Payram Crypto Payments

    PayRam/payram-mcp

    Self-hosted crypto and stablecoin payment gateway. An agent skill from PayRam/payram-mcp.

    158 GitHub stars~2k tokensUpdated yesterday
    Auto-check: notes
  • Integrate crypto payments into any web application with PayRam.

    158 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Payram Widget Integration

What does Payram Widget Integration do?

Add a PayRam "Add Credit" / tip-jar payment button to a website or web app safely. Payram Widget Integration is an agent skill from PayRam/payram-mcp. Add a PayRam "Add Credit" / tip-jar payment button to a website or web app safely.

When should I use Payram Widget Integration?

Payram Widget Integration fits situations like: adding payment capability to an existing web frontend; embedding a tip jar; credit top-up flow; writing the backend webhook handler that fulfils orders when a payment is FILLED.

How do I install Payram Widget Integration in Claude Code?

Run `npx skills add PayRam/payram-mcp --skill payram-widget-integration -a claude-code`. Or copy the skill folder (skills/payram-widget-integration in PayRam/payram-mcp) into .claude/skills/payram-widget-integration in your project. Claude Code loads it when a task matches its description.

How do I install Payram Widget Integration in Codex?

Run `npx skills add PayRam/payram-mcp --skill payram-widget-integration -a codex`. Or copy the skill folder (skills/payram-widget-integration in PayRam/payram-mcp) into .agents/skills/payram-widget-integration in your project. Codex loads it when a task matches its description.

Can I use Payram Widget Integration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add PayRam/payram-mcp --skill payram-widget-integration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/payram-widget-integration, .gemini/skills/payram-widget-integration, .github/skills/payram-widget-integration and .opencode/skills/payram-widget-integration in your project.

What does Payram Widget Integration need to run?

Going by SKILL.md and its folder, Payram Widget Integration needs the command-line tools its instructions call (curl) and credentials named PAYRAM_API_KEY and API_KEY. Our summary lists: Node.js; A credential in PAYRAM_API_KEY; A credential in API_KEY.

Does Payram Widget Integration access the network?

SKILL.md names 2 domains. In commands or code: payram.com; the agent is likely to contact it when it follows the instructions. As links in the text: docs.payram.com. This is read from the text; nothing was executed.

Is Payram Widget Integration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Payram Widget Integration use?

No licence was found for Payram Widget Integration or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Payram Widget Integration use?

About 4.5k tokens (SKILL.md is roughly 18k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Payram Widget Integration?

Skills that share tags, products or a category with Payram Widget Integration: App Builder (softspark/ai-toolkit, 179 stars), Htmx (ericrisco/rsc-harness, 167 stars), Fastcrud (benavlabs/fastcrud, 1.6k stars) and Laravel Specialist (Jeffallan/claude-skills, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Payram Widget Integration?

PayRam (a GitHub organization) maintains it in PayRam/payram-mcp, which has 158 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 7, 2026.

Source: PayRam/payram-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.