Agent skill

PayRam Bitcoin Payments

by PayRam in 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.

No licenceAuto-check passedBackend & APIs

Install PayRam Bitcoin Payments

skills CLI
$ npx skills add PayRam/payram-mcp --skill payram-bitcoin-payments -a claude-code

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

GitHub CLI
$ gh skill install PayRam/payram-mcp payram-bitcoin-payments --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-bitcoin-payments .claude/skills/payram-bitcoin-payments && 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-bitcoin-payments
GitHub stars
158
Token cost
~2.1k tokens
SKILL.md length
712 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
None found

At a glance

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.

  • Works in 4 steps: Configure Bitcoin in PayRam Dashboard → Link Mobile App → Enter Seed Phrase (Mobile Only) → …
  • Adding Bitcoin as a payment option on a self-hosted PayRam server
  • SKILL.md covers Bitcoin vs EVM Architecture, Setup Overview, Payment Flow and Integration, plus 8 more sections
  • Needs PAYRAM_API_KEY

What it does

Bitcoin works differently from the EVM chains PayRam also supports: deposit addresses are derived from an HD wallet instead of generated by smart contracts, and sweeps need manual approval in the PayRam Merchant mobile app instead of running automatically. The seed phrase is entered and stored only on the phone, so no private keys touch the server. Confirmations take roughly 10 to 60 minutes, against about 15 seconds to 2 minutes on EVM chains.

Setup has four steps: add a Bitcoin cold wallet address in the dashboard's wallet management, link the mobile app by scanning a QR code, link the wallet in the app with its 12-word seed phrase, and approve batches of pending signing requests that sweep funds to the cold wallet. Payments are created through the same API as stablecoin and crypto payments, with a payment.successful webhook event. First-time users are sent to a separate payram-setup skill.

When your agent uses it

  • Adding Bitcoin as a payment option on a self-hosted PayRam server
  • Understanding how HD wallet addresses and mobile sweep approval work
  • Wiring a Bitcoin payment flow and its success webhook into an app

Example prompts

  • “Add Bitcoin checkout to our PayRam integration and handle the payment.successful webhook.”
  • “Walk me through linking the PayRam Merchant app and approving a BTC sweep.”

Requirements

  • A configured PayRam server with API keys
  • The PayRam Merchant mobile app
  • A Bitcoin cold wallet address

Workflow steps

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

  1. Configure Bitcoin in PayRam Dashboard
  2. Link Mobile App
  3. Enter Seed Phrase (Mobile Only)
  4. Approve Sweeps via Mobile

What it can do on your machine

Read from SKILL.md and the folder at commit fbeab44. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are javascript and json).

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

  • Network

    Links to these hosts (documentation or services it may open):

    • t.me
    • payram.com
    • github.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

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

Context cost

PayRam Bitcoin Payments loads about 2.1k tokens when it runs. Until then it costs about 118 tokens; SKILL.md has 712 words of instructions outside code blocks.

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

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 712 words (~2,143 tokens).

“PayRam supports on-chain Bitcoin with a unique architecture: HD wallet derivation for deposits, mobile app signing for sweeps—no private keys ever touch the server.”

— opening of SKILL.md by PayRam
name
payram-bitcoin-payments

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/payram-bitcoin-payments of PayRam/payram-mcp.

Open the folder on GitHubat commit fbeab44

Compare with similar skills

PayRam Bitcoin Payments 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 Bitcoin Payments compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PayRam Bitcoin Payments this skillPayRam/payram-mcp158—~2.1kAutomated safety check: PassNone
Yalidine Delivery Integrationbighadj22/codflow354—~2.5kAutomated safety check: PassApache-2.0
Discord Php Bot Securitydiscord-php/DiscordPHP1.1k—~1.2kAutomated safety check: NotesMIT
Stripe Best Practicesfossasia/eventyay1.7k1 repos~1.7kAutomated safety check: PassApache-2.0
Pinme Uniwebpayglitternetwork/pinme3.8k—~7.3kAutomated safety check: PassMIT
Telegram Development Guide2025Emma/vibe-coding-cn23k1 repos~3.7kAutomated safety check: PassMIT

Similar skills

  • Wires an app to the Yalidine (Guepex) Algerian courier API: parcels, zone lookups, delivery fees and verified delivery-status webhooks.

    354 GitHub stars~2.5k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed
  • Discord Php Bot Security

    discord-php/DiscordPHP

    Audit checklist for DiscordPHP bots and API libraries — stop the bot token leaking to third-party APIs or logs, keep secrets out of customids and exception messages, use constant-time comparison and…

    1.1k GitHub stars~1.2k tokensUpdated today
    Backend & APIsAuto-check: notes
  • Stripe Best Practices

    fossasia/eventyay

    Guides Stripe integration decisions across development and test environment planning (separate sandboxes vs the shared test mode sandbox), API selection (Checkout Sessions vs PaymentIntents)…

    1.7k GitHub starsUsed in 1 repo~1.7k tokens
    Backend & APIsAuto-check passed
  • Pinme Uniwebpay

    glitternetwork/pinme

    A skill your agent uses when generating, modifying, or reviewing PinMe Worker (Cloudflare Worker TypeScript) code that accepts payments through UniwebPay — payment links, products/prices, checkout…

    3.8k GitHub stars~7.3k tokensUpdated 29 days ago
    Backend & APIsAuto-check passed
  • Telegram Development Guide

    2025Emma/vibe-coding-cn

    Chinese-language guide to building on Telegram: bots through the Bot API, Mini Apps in JavaScript and custom clients through TDLib, with Python examples.

    23k GitHub starsUsed in 1 repo~3.7k tokens
    Backend & APIsAuto-check passed
  • Bfl API

    black-forest-labs/skills

    BFL FLUX API integration guide covering endpoints, async polling patterns, rate limiting, error handling, webhooks, and regional endpoints with Python and TypeScript code examples.

    128 GitHub starsUsed in 1 repo~2.5k tokens
    Backend & APIsAuto-check: notes

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 3 days ago
    Auto-check passed
  • Payram Auth

    PayRam/payram-mcp

    Authenticate with a PayRam instance to access merchant dashboard APIs.

    158 GitHub stars~2.2k tokensUpdated 3 days ago
    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 3 days ago
    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 3 days ago
    Auto-check: notes
  • Integrate crypto payments into any web application with PayRam.

    158 GitHub stars~1.8k tokensUpdated 3 days ago
    Auto-check passed
  • Payram Payouts

    PayRam/payram-mcp

    Send crypto payouts and manage referral programs with PayRam.

    158 GitHub stars~4.2k tokensUpdated 3 days ago
    Auto-check passed

Works with

Categories

Questions about PayRam Bitcoin Payments

What does PayRam Bitcoin Payments do?

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. Bitcoin works differently from the EVM chains PayRam also supports: deposit addresses are derived from an HD wallet instead of generated by smart contracts, and sweeps need manual approval in the PayRam Merchant mobile app instead of running automatically. The seed phrase is entered and stored only on the phone, so no private keys touch the server.

When should I use PayRam Bitcoin Payments?

PayRam Bitcoin Payments fits situations like: adding Bitcoin as a payment option on a self-hosted PayRam server; understanding how HD wallet addresses and mobile sweep approval work; wiring a Bitcoin payment flow and its success webhook into an app.

How do I install PayRam Bitcoin Payments in Claude Code?

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

How do I install PayRam Bitcoin Payments in Codex?

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

Can I use PayRam Bitcoin Payments 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-bitcoin-payments -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-bitcoin-payments, .gemini/skills/payram-bitcoin-payments, .github/skills/payram-bitcoin-payments and .opencode/skills/payram-bitcoin-payments in your project.

What does PayRam Bitcoin Payments need to run?

Going by SKILL.md and its folder, PayRam Bitcoin Payments needs credentials named PAYRAM_API_KEY. Our summary lists: A configured PayRam server with API keys; The PayRam Merchant mobile app; A Bitcoin cold wallet address.

Does PayRam Bitcoin Payments access the network?

SKILL.md names 3 domains. As links in the text: t.me, payram.com and github.com. This is read from the text; nothing was executed.

Is PayRam Bitcoin Payments 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 Bitcoin Payments use?

No licence was found for PayRam Bitcoin Payments or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does PayRam Bitcoin Payments use?

About 2.1k tokens (SKILL.md is roughly 8.6k 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 Bitcoin Payments?

Skills that share tags, products or a category with PayRam Bitcoin Payments: Yalidine Delivery Integration (bighadj22/codflow, 354 stars), Discord Php Bot Security (discord-php/DiscordPHP, 1.1k stars), Stripe Best Practices (fossasia/eventyay, 1.7k stars) and Pinme Uniwebpay (glitternetwork/pinme, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PayRam Bitcoin Payments?

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 8, 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.