Grapes Finance · Capability

Grapes Finance API

Grapes is an embedded stablecoin onramp and offramp solution that enables businesses and developers to integrate fiat-to-stablecoin and stablecoin-to-fiat transactions. Supports buying and selling stablecoins such as USDC and QCAD with CAD and USD across Ethereum, Algorand, and Stellar networks.

Run with Naftiko GrapesFinanceAPI

What You Can Do

GET
Get users — List users
/users
POST
Post users — Create user
/users
GET
Get users userid — Get user
/users/{userId}
POST
Post kyc — Submit KYC application
/kyc
GET
Get wallets — List wallets
/wallets
POST
Post wallets — Create wallet
/wallets
GET
Get orders — List orders
/orders
POST
Post orders — Create order
/orders
GET
Get contacts — List contacts
/contacts
POST
Post contacts — Create contact
/contacts
GET
Get organizations — List organizations
/organizations
POST
Post organizations — Create organization
/organizations

MCP Tools

get-users

List users

read-only idempotent
post-users

Create user

get-users-userid

Get user

read-only idempotent
post-kyc

Submit KYC application

get-wallets

List wallets

read-only idempotent
post-wallets

Create wallet

get-orders

List orders

read-only idempotent
post-orders

Create order

get-contacts

List contacts

read-only idempotent
post-contacts

Create contact

get-organizations

List organizations

read-only idempotent
post-organizations

Create organization

Capability Spec

grapes-finance-capability.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: Grapes Finance API
  description: Grapes is an embedded stablecoin onramp and offramp solution that enables businesses and developers to integrate
    fiat-to-stablecoin and stablecoin-to-fiat transactions. Supports buying and selling stablecoins such as USDC and QCAD
    with CAD and USD across Ethereum, Algorand, and Stellar networks.
  tags:
  - Grapes
  - Finance
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: grapes-finance
    baseUri: https://api.demo.grapesfinance.com
    description: Grapes Finance API HTTP API.
    authentication:
      type: apikey
      in: header
      name: X-API-Key
      value: '{{GRAPES_FINANCE_TOKEN}}'
    resources:
    - name: users
      path: /users
      operations:
      - name: get-users
        method: GET
        description: List users
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: post-users
        method: POST
        description: Create user
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: users-userid
      path: /users/{userId}
      operations:
      - name: get-users-userid
        method: GET
        description: Get user
        inputParameters:
        - name: userId
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: kyc
      path: /kyc
      operations:
      - name: post-kyc
        method: POST
        description: Submit KYC application
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: wallets
      path: /wallets
      operations:
      - name: get-wallets
        method: GET
        description: List wallets
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: post-wallets
        method: POST
        description: Create wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orders
      path: /orders
      operations:
      - name: get-orders
        method: GET
        description: List orders
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: post-orders
        method: POST
        description: Create order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: contacts
      path: /contacts
      operations:
      - name: get-contacts
        method: GET
        description: List contacts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: post-contacts
        method: POST
        description: Create contact
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: organizations
      path: /organizations
      operations:
      - name: get-organizations
        method: GET
        description: List organizations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: post-organizations
        method: POST
        description: Create organization
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: grapes-finance-rest
    description: REST adapter for Grapes Finance API.
    resources:
    - path: /users
      name: get-users
      operations:
      - method: GET
        name: get-users
        description: List users
        call: grapes-finance.get-users
        outputParameters:
        - type: object
          mapping: $.
    - path: /users
      name: post-users
      operations:
      - method: POST
        name: post-users
        description: Create user
        call: grapes-finance.post-users
        outputParameters:
        - type: object
          mapping: $.
    - path: /users/{userId}
      name: get-users-userid
      operations:
      - method: GET
        name: get-users-userid
        description: Get user
        call: grapes-finance.get-users-userid
        with:
          userId: rest.userId
        outputParameters:
        - type: object
          mapping: $.
    - path: /kyc
      name: post-kyc
      operations:
      - method: POST
        name: post-kyc
        description: Submit KYC application
        call: grapes-finance.post-kyc
        outputParameters:
        - type: object
          mapping: $.
    - path: /wallets
      name: get-wallets
      operations:
      - method: GET
        name: get-wallets
        description: List wallets
        call: grapes-finance.get-wallets
        outputParameters:
        - type: object
          mapping: $.
    - path: /wallets
      name: post-wallets
      operations:
      - method: POST
        name: post-wallets
        description: Create wallet
        call: grapes-finance.post-wallets
        outputParameters:
        - type: object
          mapping: $.
    - path: /orders
      name: get-orders
      operations:
      - method: GET
        name: get-orders
        description: List orders
        call: grapes-finance.get-orders
        outputParameters:
        - type: object
          mapping: $.
    - path: /orders
      name: post-orders
      operations:
      - method: POST
        name: post-orders
        description: Create order
        call: grapes-finance.post-orders
        outputParameters:
        - type: object
          mapping: $.
    - path: /contacts
      name: get-contacts
      operations:
      - method: GET
        name: get-contacts
        description: List contacts
        call: grapes-finance.get-contacts
        outputParameters:
        - type: object
          mapping: $.
    - path: /contacts
      name: post-contacts
      operations:
      - method: POST
        name: post-contacts
        description: Create contact
        call: grapes-finance.post-contacts
        outputParameters:
        - type: object
          mapping: $.
    - path: /organizations
      name: get-organizations
      operations:
      - method: GET
        name: get-organizations
        description: List organizations
        call: grapes-finance.get-organizations
        outputParameters:
        - type: object
          mapping: $.
    - path: /organizations
      name: post-organizations
      operations:
      - method: POST
        name: post-organizations
        description: Create organization
        call: grapes-finance.post-organizations
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: grapes-finance-mcp
    transport: http
    description: MCP adapter for Grapes Finance API for AI agent use.
    tools:
    - name: get-users
      description: List users
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: grapes-finance.get-users
      outputParameters:
      - type: object
        mapping: $.
    - name: post-users
      description: Create user
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: grapes-finance.post-users
      outputParameters:
      - type: object
        mapping: $.
    - name: get-users-userid
      description: Get user
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: grapes-finance.get-users-userid
      with:
        userId: tools.userId
      inputParameters:
      - name: userId
        type: string
        description: userId
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: post-kyc
      description: Submit KYC application
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: grapes-finance.post-kyc
      outputParameters:
      - type: object
        mapping: $.
    - name: get-wallets
      description: List wallets
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: grapes-finance.get-wallets
      outputParameters:
      - type: object
        mapping: $.
    - name: post-wallets
      description: Create wallet
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: grapes-finance.post-wallets
      outputParameters:
      - type: object
        mapping: $.
    - name: get-orders
      description: List orders
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: grapes-finance.get-orders
      outputParameters:
      - type: object
        mapping: $.
    - name: post-orders
      description: Create order
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: grapes-finance.post-orders
      outputParameters:
      - type: object
        mapping: $.
    - name: get-contacts
      description: List contacts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: grapes-finance.get-contacts
      outputParameters:
      - type: object
        mapping: $.
    - name: post-contacts
      description: Create contact
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: grapes-finance.post-contacts
      outputParameters:
      - type: object
        mapping: $.
    - name: get-organizations
      description: List organizations
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: grapes-finance.get-organizations
      outputParameters:
      - type: object
        mapping: $.
    - name: post-organizations
      description: Create organization
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: grapes-finance.post-organizations
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    GRAPES_FINANCE_TOKEN: GRAPES_FINANCE_TOKEN