doku-gemini-mcp
DOKU Gemini MCP Plugin oku-gemini-mcp is an advanced AI plugin and Model Context Protocol (MCP) server for Google Antigravity, Gemini, Claude Desktop, and Cursor. It equips AI coding assistants with end-to-end capabilities to scaffold, configure, test, sign, and maintain
Install / Use
claude mcp add roedyrustam -- npx -y github:roedyrustam/doku-gemini-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Finance & AccountingSupported Platforms
Tags
Our assessment of doku-gemini-mcp
doku-gemini-mcp scores 83/100 on our quality scale, 76th of 108 Finance & Accounting skills we index.
Its MCP Server is 16 KB long, well organised into 28 sections with 8 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 4 days ago, so doku-gemini-mcp is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-21. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
doku-gemini-mcp compared with similar skills
All 4 of these similar skills score higher than doku-gemini-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| doku-gemini-mcp (this skill)by roedyrustam | 83 | 3 | 4d ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 114.0k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.3k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.5k | today | CLAUDE.md |
Frequently asked questions
- How do I install doku-gemini-mcp?
- Run
claude mcp add roedyrustam -- npx -y github:roedyrustam/doku-gemini-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does doku-gemini-mcp work with?
- It is written for Claude Code, Claude Desktop, Cursor and Gemini CLI, as a MCP Server file. Other agents that read the same format can often use it too.
- Is doku-gemini-mcp safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is doku-gemini-mcp still maintained?
- The repository was last updated 4 days ago, so doku-gemini-mcp is actively maintained.
Skill content
View source on GitHubDOKU Gemini MCP Plugin & Server (doku-gemini-mcp)
Official Antigravity / Gemini Plugin & Model Context Protocol (MCP v1.x) Server for DOKU Payment Gateway (Jokul API v2 & Bank Indonesia SNAP BI v1.0)
Plugin & Server MCP AI Agentic Commerce untuk Integrasi DOKU Payment Gateway Resmi (developers.doku.com).
English | Bahasa Indonesia | Tools Matrix | Documentation Index
⚡ 1-Command Agentic Workflow Architecture
sequenceDiagram
autonumber
actor Developer as 🧑💻 Developer
participant Agent as 🤖 AI Assistant (Antigravity / Claude / Cursor)
participant MCP as 🔌 doku-gemini-mcp Server
participant DOKU as 🏦 DOKU Gateway (Sandbox / Production)
Developer->>Agent: "Create DOKU checkout link for invoice INV-101 Rp 50.000"
Agent->>MCP: Call tool `create_checkout_payment` via Stdio JSON-RPC
MCP->>MCP: Compute Base64 SHA-256 Digest & HMAC-SHA256 Signature
MCP->>DOKU: POST /checkout/v1/payment (Signed HTTPS Request)
DOKU-->>MCP: HTTP 200 OK (Payment URL & Token)
MCP-->>Agent: Structured JSON with payment.url
Agent-->>Developer: 🚀 "Checkout link generated: https://jokul.doku.com/..."
<a name="english"></a>
English
Overview
doku-gemini-mcp is an advanced AI plugin and Model Context Protocol (MCP v1.x) server designed for Google Antigravity, Gemini CLI, Claude Desktop, and Cursor. It empowers AI coding assistants with end-to-end capabilities to scaffold, configure, test, sign, and execute DOKU Payment Gateway financial transactions autonomously.
Built upon a Dual-Engine Architecture, it seamlessly bridges:
- Jokul API v2: Hosted DOKU Checkout (Pop-up Modal & Redirect), Cancel Order API, Direct Virtual Accounts (BCA, Mandiri, BRI, BNI, Permata, Danamon, CIMB), Direct QRIS, E-Wallets (OVO, ShopeePay, DANA, LinkAja), Credit Card 3DS, and Online Refunds.
- Bank Indonesia SNAP BI v1.0: Standard National Open API Payment protocols, Asymmetric RSA-2048 SHA256withRSA B2B Token generation (
POST /authorization/v1/access-token/b2b), and Symmetric HMAC-SHA512 SNAP QRIS MPM (POST /snap-adapter/b2b/v1.0/qr/qr-mpm-generate).
Key Capabilities
- 9 Production MCP Tools: Autonomous AI tools for Checkout, Cancellations, Virtual Accounts, QRIS, E-Wallets, Order Inquiry, Refunds, and SNAP BI Token/QRIS.
- 12 Specialized Agentic Skills: Stack detection, project setup, credential configuration, Postman collection generation, live sandbox testing, and production audits.
- Executable Automation CLI: Ready-to-run scripts for static security audits, Postman collection exports, and live sandbox connectivity.
- Cryptographic Strictness: Built-in HMAC-SHA256, SNAP RSA-2048 SHA256withRSA, SNAP HMAC-SHA512, and
crypto.timingSafeEqualwebhook validation. - Zero-Friction Stdio Server: Packaged into a fast, single-file bundle (
dist/index.js, 30 KB) that runs out-of-the-box in Claude Desktop, Cursor, and Antigravity. - 100% Tested: Vitest unit test suite with 15 passing tests and 6/6 security invariant checks.
<a name="bahasa-indonesia"></a>
Bahasa Indonesia
Ringkasan
doku-gemini-mcp adalah plugin AI dan server Model Context Protocol (MCP v1.x) resmi untuk Google Antigravity, Gemini, Claude Desktop, dan Cursor. Plugin ini membekali asisten AI dengan kemampuan end-to-end untuk membuat, mengonfigurasi, menguji, menandatangani, dan memelihara integrasi DOKU Payment Gateway.
Didukung oleh Arsitektur Dual-Engine, plugin ini mengintegrasikan dua pilar resmi DOKU:
- Jokul API v2: DOKU Checkout (Popup Modal & Redirect), Cancel Order API, Virtual Account Langsung (BCA, Mandiri, BRI, BNI, Permata, Danamon, CIMB), QRIS Dinamis, E-Wallet (OVO, ShopeePay, DANA, LinkAja), Kartu Kredit 3DS, dan Online Refund.
- Bank Indonesia SNAP BI v1.0: Standar Nasional Open API Pembayaran, signature asimetris RSA-2048 SHA256withRSA untuk token B2B OAuth 2.0 (
POST /authorization/v1/access-token/b2b), dan signature simetris HMAC-SHA512 untuk SNAP QRIS MPM (POST /snap-adapter/b2b/v1.0/qr/qr-mpm-generate).
Fitur Utama
- 9 Production MCP Tools: Tool otonom untuk membuat link checkout, membatalkan pesanan, menerbitkan Virtual Account, membuat QRIS, inisiasi e-wallet, cek status invoice, refund online, dan SNAP BI token/QRIS.
- 12 Skill Agen Terpesialisasi: Deteksi stack otomatis, setup proyek, konfigurasi kredensial, pembuat koleksi Postman, penguji sandbox langsung, dan audit produksi.
- Rangkaian Skrip Otomasi CLI: Skrip mandiri untuk audit keamanan statis, ekspor koleksi Postman v2.1, dan pengujian konektivitas sandbox.
- Ketepatan Kriptografis: Kalkulator signature HMAC-SHA256, SNAP RSA-SHA256, SNAP HMAC-SHA512, dan validator webhook timing-safe (
crypto.timingSafeEqual). - Server Stdio Siap Pakai: Terkompilasi ke dalam bundle tunggal super cepat (
dist/index.js, 30 KB) yang langsung bekerja tanpa kompilasi tambahan.
🛠️ Model Context Protocol (MCP) Server — 9 Production Tools
The DOKU MCP Server exposes 9 native tools to LLM agents for autonomous financial operations via JSON-RPC 2.0 over Stdio:
| # | MCP Tool Name | Target Endpoint | Description | Mandatory Parameters |
|---|---|---|---|---|
| 1 | create_checkout_payment | POST /checkout/v1/payment | Generates a DOKU Checkout Payment Link URL (Popup modal / redirect). | amount, invoice_number, customer_name, customer_email |
| 2 | cancel_checkout_order | POST /checkout/v3/cancellations | Voids an unpaid checkout order before expiry. | invoice_number |
| 3 | create_virtual_account | POST /doku-virtual-account/v2/payment-code | Generates a direct bank Virtual Account (BCA, Mandiri, BRI, BNI, Permata, Danamon, CIMB). | bank_code, amount, invoice_number, customer_name |
| 4 | create_qris_payment | POST /qris/v1/payment-code | Generates dynamic QRIS payment code and QR image string (Jokul v2). | amount, invoice_number |
| 5 | create_ewallet_payment | POST /e-wallet/v1/payment | Initiates an E-Wallet charge (OVO, ShopeePay, DANA, LinkAja). | channel, amount, invoice_number |
| 6 | check_transaction_status | GET /orders/v1/status/:invoice_number | Queries real-time invoice payment status from DOKU API. | invoice_number |
| 7 | process_refund | POST /orders/v1/refund | Initiates an online refund for an existing settled transaction. | invoice_number, amount, reason |
| 8 | get_snap_b2b_token | POST /authorization/v1/access-token/b2b | Obtains a SNAP BI OAuth 2.0 B2B Access Token via Asymmetric RSA-SHA256. | — (private_key_pem optional) |
| 9 | create_snap_qris_payment | POST /snap-adapter/b2b/v1.0/qr/qr-mpm-generate | Generates dynamic QRIS adhering to Bank Indonesia SNAP standard via HMAC-SHA512. | partner_reference_no, amount_value, access_token |
🚀 Installation & Client Setup
Option 1: Direct Execution via NPX (Recommended for Claude Desktop & Cursor)
No cloning or local building needed. Run directly using Node/npx:
{
"mcpServers": {
"doku": {
"command": "npx",
"args": ["-y", "doku-gemini-mcp"],
"env": {
"DOKU_CLIENT_ID": "YOUR_SANDBOX_CLIENT_ID",
"DOKU_SECRET_KEY": "YOUR_SANDBOX_SECRET_KEY",
"DOKU_IS_PRODUCTION": "false"
}
}
}
}
Option 2: Global Installation for Antigravity IDE & Gemini CLI
Installing the plugin globally allows Antigravity IDE and Gemini CLI to auto-discover all 12 skills, rules, and the MCP server across all workspaces:
# Windows (PowerShell)
git clone https://github.com/roedyrustam/doku-gemini-mcp.git "$env:USERPROFILE\.gemini\config\plugins\doku-gemini-mcp"
# macOS / Linux / WSL
git clone https://github.com/roedyrustam/doku-gemini-mcp.git ~/.gemini/config/plugins/doku-gemini-mcp
Register in ~/.gemini/antigravity-ide/mcp_config.json:
{
"mcpServers": {
"doku": {
"command": "node",
"args": ["C:/Users/YOUR_USER/.gemini/config/plugins/doku-gemini-mcp/dist/index.js"],
"env": {
"DOKU_CLIENT_ID": "YOUR_SANDBOX_CLIENT_ID",
"DOKU_SECRET_KEY": "YOUR_SANDBOX_SECRET_KEY",
"DOKU_IS_PRODUCTION": "false"
}
}
}
}
Option 3: Claude Desktop Configuration
File location:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"doku": {
"command": "node",
"args": ["/path/to/doku-gemini-mcp/dist/index.js"],
"env": {
"DOKU_CLIENT_ID": "YOUR_SANDBOX_CLIENT_ID",
"DOKU_SECRET_KEY": "YOUR_SANDBOX_SECRET_KEY",
"DOKU_PRIVATE_KEY_PEM": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----",
"DOKU_IS_PRODUCTION": "false"
}
}
}
}
[!TIP]
- Get free Sandbox credentials at DOKU Sandbox Back Office.
- Test customer payments and webhooks using the DOKU Integration Payment Simulator.
🔑 Environment Variables Reference
| Variable Name | Required | Default | Description |
|---|---|---|---|
| DOKU_CLIENT_ID | Yes | — | Merchant Client ID from DOKU Back Office. |
| DOKU_SECRET_KEY | Yes | — | Merchant Secret Key used for HMAC signature computation. |
| DOKU_IS_PRODUCTION | No | false | Set to true to hit live gateway (https://api.doku.com). Defaults to false (Sandbox: https://api-sandbox.doku.com). |
| DOKU_PRIVATE_KEY_PEM | No | — | Merchant RSA Private Key in PEM format (required for SNAP BI Asymmetric Token). |
💻 Programmatic SDK Usage (Node.js & TypeScript)
In addition to serving as an MCP server, doku-gemini-mcp exports its core client and cryptographic utilities directly:
import { DokuClient, calculateJokulSignature, verifyWebhookSignature } from 'doku-gemini-mcp';
// 1. Initialize Client
const client = new DokuClient({
clientId: process.env.DOKU_CLIENT_ID,
secretKey: process.env.DOKU_SECRET_KEY,
isProduction: false, // Sandbox mode
});
// 2. Generate Checkout Link
const checkout = await client.createCheckoutPayment({
order: {
amount: 50000,
invoice_number: 'INV-20261105-001',
callback_url: 'https://mywebsite.com/payment/finish',
},
customer: {
name: 'Budi Santoso',
email: 'budi@example.com',
},
});
console.log('Payment URL:', checkout.response.payment.url);
⚡ Executable Automation CLI Scripts
The repository includes a ready-to-run suite of automation scripts in scripts/:
# 1. Run security and signature compliance audit
pnpm run audit
# 2. Export Postman Collection v2.1 with dynamic CryptoJS HMAC scripts
pnpm run export-postman
# 3. Test live connectivity against DOKU Sandbox
pnpm run test-sandbox
# 4. Auto-detect project tech stack and save .doku-config.json
node scripts/detect-stack.mjs
# 5. Run Vitest unit test suite (15 tests)
pnpm test
# 6. Build production bundle (tsup)
pnpm run build
📖 12 Specialized Agentic Sk
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
114.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.3k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.5kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
