MCP 서버

ROKI Connect

            la.roki/connect
        

개발자 도구 결제 및 핀테크 공개 · 연결 가능 MCP 2025-11-25

이 MCP로 할 수 있는 일

Provides documentation, schemas, validation, examples, sandbox execution, and troubleshooting tools for integrating ROKI Connect payments.

roki_audit_integration

Audit ROKI integration code against the verified contract

Return the checklist to audit existing ROKI code, ordered by how badly each item fails in production. Use it when reviewing an integration you did not write, or before going live.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'focus': {'type': 'string', 'description': 'Optional area: "webhooks", "security", "payments", "reversals".'}}}

roki_check_result

Check a ROKI payment response against the request that produced it

Compare the payment the API returned against the body you sent, and report anything that does not match. Every other check here looks at what you SEND. This one exists for the errors that survive that: the field name was right and the VALUE was wrong. The API answers 201, `warnings` comes back empty because there was nothing to warn about, and the merchant charged something else. Catches the amount off by a factor of 100, fee pass-through asked for and returned as zero, tax that was not applied, `expires_at` already in the past because it was sent as UTC instead of Honduras time, a total that does not add up, and a `transaction_id` parsed as a number. Run it after every createPayment while you are building, and in your own tests afterwards.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sent', 'received'], 'properties': {'sent': {'type': 'object', 'description': 'The JSON request body you sent to POST /payments.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'received': {'type': 'object', 'description': 'The payment object the API returned. Paste the response as-is.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}

roki_choose_integration_mode

Choose the right ROKI integration approach

Decide how to integrate ROKI Connect for a given project (web checkout, embedded card fields, mobile app, invoices or recurring billing) and get the constraints that apply before writing code. The modes and the endpoints behind them are read from the corpus, so this answer cannot describe a mode the API no longer has - or miss one it gained.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['context'], 'properties': {'context': {'type': 'string', 'description': 'What the project is: e.g. "Laravel e-commerce checkout", "iOS app", "card fields on my own page", "invoices from an ERP", "monthly subscriptions".'}}}

roki_get_authentication_guide

ROKI Connect authentication and credentials

How authentication works, how the two environments are selected, where credentials come from, and how to store and rotate them safely.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

roki_get_doc_section

Read a section of the ROKI Connect guide

Return the complete text of one section of the integration guide, by number (e.g. "14"), sub-number ("12.1") or title fragment ("webhook").

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ref'], 'properties': {'ref': {'type': 'string', 'description': 'Section number, sub-number, or a fragment of its title.'}}}

roki_get_error

Explain a ROKI Connect error

Explain an HTTP status or an error message returned by the ROKI API: what it means, the likely cause and what to do. Use this instead of guessing when an integration fails.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['error'], 'properties': {'error': {'type': 'string', 'description': 'HTTP status ("422"), or a fragment of the message ("Pago no encontrado", "route could not be found", "sandbox").'}}}

roki_get_integration_example

Get a runnable ROKI Connect integration example

Return a complete, runnable integration example for a stack: configuration, API client, checkout flow, webhook handler with signature verification, and polling fallback.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'stack': {'type': 'string', 'description': 'e.g. "laravel", "php", "node", "express", "python", "fastapi". Omit to list what is available.'}}}

roki_get_operation

Get a ROKI Connect API operation in full

Full detail for one operation: method, path, headers, request schema field table, responses, and worked examples.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['operation'], 'properties': {'operation': {'type': 'string', 'description': 'operationId (e.g. "createPayment"), or "METHOD /path" (e.g. "POST /payments").'}}}

roki_get_quickstart

ROKI Connect quickstart

The minimum viable integration sequence, end to end, including the manual portal steps a developer cannot skip.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

roki_get_schema

Get a ROKI Connect schema

Return a fully dereferenced JSON Schema by name (e.g. "PaymentCreateRequest", "Payment", "WebhookEvent"). Use it to know the exact field names, types and constraints.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string', 'description': 'Schema name. Omit to list all available schemas.'}}}

roki_get_webhook_guide

ROKI Connect webhooks

Everything about webhooks: portal registration, event types, payload shape, HMAC signature verification over the raw body, idempotent processing, and the polling fallback.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

roki_list_operations

List ROKI Connect API operations

List every operation the API actually exposes, plus the operations that are documented as NOT existing. Call this before writing any integration code so you never invent an endpoint.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

roki_sandbox_info

What the sandbox playground can run

Whether the sandbox playground is enabled here, which operations it accepts, its limits, and the sandbox test cards.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

roki_sandbox_try

Execute an operation against the ROKI sandbox and see the real response

Runs a documented operation against the ROKI sandbox using THIS SERVER'S own test credential, and returns the actual response. Use it to prove an integration works instead of assuming it does - especially after roki_validate_request says a payload is valid. You never supply a key: this server holds a sandbox-only credential and refuses to run against production. Amounts are capped and links expire quickly, because the sandbox is shared.

외부 접근 가능

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['operation'], 'properties': {'payload': {'type': 'object', 'description': 'Request body for POST operations, or path values such as {"id": 123} / {"transaction_id": "uuid"}.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'operation': {'type': 'string', 'description': 'operationId to run, e.g. "createPayment", "getPayment", "voidTransaction".'}}}

roki_scaffold_integration

Scaffold a complete ROKI Connect integration

Return the full runnable skeleton for a stack: credential storage, API client, checkout flow, webhook handler with signature verification, and the polling fallback. Use it to start an integration instead of assembling one from memory.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['stack'], 'properties': {'mode': {'type': 'string', 'description': '"hosted" (default), "embedded" or "saved-card".'}, 'stack': {'type': 'string', 'description': 'e.g. "laravel", "node", "express", "python", "fastapi", "php".'}}}

roki_search_docs

Search ROKI Connect documentation

Search the official ROKI Connect corpus (integration guide, API operations and schemas) and return ranked excerpts. Use this first when you need any ROKI-specific fact. Never answer a ROKI question from memory or from another payment gateway's conventions.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 15, 'minimum': 1, 'description': 'Maximum results (default 6).'}, 'query': {'type': 'string', 'minLength': 2, 'description': 'What you need to know, e.g. "webhook signature", "tip fields", "idempotency".'}}}

roki_status

ROKI Connect MCP server status

Server version, corpus contents and freshness. Safe first call to confirm the connection works. Exposes no credentials and no merchant data.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

roki_validate_request

Validate a ROKI Connect request payload

Validate a payload against the official schema WITHOUT sending it, and check the business rules the API enforces. Critical for this API: it ignores unknown fields and returns 201, so a typo produces a misconfigured payment rather than an error. The response names what it dropped in `warnings`, but by then the payment exists - validating here means it is never created. Always validate before writing or shipping integration code.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['operation', 'payload'], 'properties': {'payload': {'type': 'object', 'description': 'The JSON request body you intend to send.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'operation': {'type': 'string', 'description': 'operationId, e.g. "createPayment".'}}}

roki_verify_webhook_signature

Verify a ROKI webhook signature and diagnose why it fails

Check a ROKI-Signature header against the raw body and the signing secret. When it fails, this does not just say "invalid" - it tries the specific wrong constructions developers actually write and tells you which mistake you made. Use it whenever webhook verification rejects real events. On the signing secret: this is ROKI's own server and ROKI issued that secret, so sending it here discloses nothing new. It is used to recompute the HMAC and is never stored, logged or counted.

읽기 전용 멱등성

입력 스키마

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['raw_body', 'signature_header', 'signing_secret'], 'properties': {'raw_body': {'type': 'string', 'description': 'The EXACT raw request body as received, byte for byte, before any JSON parsing.'}, 'signing_secret': {'type': 'string', 'description': 'The signing secret from the portal, for the same environment as the event. Held in memory for the duration of the call only: this server logs no tool arguments.'}, 'signature_header': {'type': 'string', 'description': 'The full ROKI-Signature header value, e.g. "t=1719234300,v1=8f3c..."'}}}

추가됨

                            roki_status
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_sandbox_info
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_sandbox_try
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_audit_integration
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_scaffold_integration
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_verify_webhook_signature
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_choose_integration_mode
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_get_webhook_guide
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_get_authentication_guide
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_get_quickstart
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_get_integration_example
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_check_result
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_validate_request
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_get_error
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_get_schema
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_get_operation
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_list_operations
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_get_doc_section
                        

2026년 9월 17일 12:54 PM

추가됨

                            roki_search_docs
                        

2026년 9월 17일 12:54 PM

서버 정보

버전

1.0.0

전송 방식

Streamable HTTP

도구

지연 시간

1789 ms

마지막 스캔

2026년 10월 1일 2:50 AM

최초 확인

2026년 9월 13일 2:25 AM

엔드포인트

https://mcp.roki.la/mcp

최근 스캔

성공

2026년 10월 1일 2:50 AM

성공

2026년 9월 29일 2:59 AM

성공

2026년 9월 27일 2:50 AM

성공

2026년 9월 25일 2:59 AM

성공

2026년 9월 23일 2:50 AM

성공

2026년 9월 21일 2:57 AM

성공

2026년 9월 19일 2:48 AM

성공

2026년 9월 17일 12:54 PM

ROKI Connect

이 MCP로 할 수 있는 일

도구

최근 도구 변경

유사한 MCP 서버

PayRam Helper MCP Server

Slid Phi Labs

AgentPay — Pay-per-call AI Microservices

SALT19 Agent Utility Grid

SparkPay

trading-mcp

htmlweb.ru — справочники и проверки для AI

x402 Doctor