# Finance

> A Claude skill from br3eze-code/br3eze-code.

- **Type:** Skill
- **Install:** `agentstack add skill-br3eze-code-br3eze-code-finance`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [br3eze-code](https://agentstack.voostack.com/s/br3eze-code)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [br3eze-code](https://github.com/br3eze-code)
- **Source:** https://github.com/br3eze-code/br3eze-code/tree/main/skills/finance
- **Website:** https://br3eze.africa

## Install

```sh
agentstack add skill-br3eze-code-br3eze-code-finance
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Skill: finance

**Version:** 2026.7.0  
**Dispatcher:** `manage_finance`  
**Domain:** finance

## Description

Financial engine for AgentOS operators — revenue reports, 7-day trend data, audit trail, enhanced P2P credit transfers (with phone/email/username resolution and fee support), and Mastercard Account-to-Account (A2A) payment initiation and status tracking.

## When to Use

Invoke when the user asks about:

- Revenue summary or income reports
- 7-day voucher sales trends
- Audit logs or transaction history
- Sending credits to another user (P2P transfer)
- Looking up a user by phone, email, or username
- Initiating a Mastercard A2A payment for a voucher
- Checking the status of a Mastercard payment

## Tools

| Action | Description |
|---|---|
| `finance.report` | All-time revenue summary grouped by plan |
| `finance.trends` | 7-day daily revenue trend |
| `finance.audit` | Last N audit events |
| `p2p.transfer` | Transfer credits between users with fee deduction |
| `p2p.resolve` | Resolve phone/email/username → Firebase UID |
| `mastercard.initiate` | Initiate A2A bank-to-wallet payment |
| `mastercard.status` | Check status of an initiated payment |

## Parameters

**P2P Transfer:**

```json
{
  "action": "p2p.transfer",
  "from": "uid_sender",
  "to": "+254712345678",
  "amount": 5.00
}
```

**Mastercard Initiate:**

```json
{
  "action": "mastercard.initiate",
  "voucherCode": "STAR-4A2F-QWTQ",
  "amount": 5.00,
  "currency": "USD"
}
```

## P2P Identity Resolvers

Recipient can be specified as:

- **Phone (E.164):** `+254712345678`
- **Email:** `alice@example.com`
- **Username:** `alice`

## Fee Logic

Configured via environment variables:

- `P2P_FEE_PERCENT` — percentage fee (default: `0`)
- `P2P_FEE_FLAT` — flat fee in USD (default: `0`)

Dual-entry bookkeeping: `p2p_transfer_sent` and `p2p_transfer_received` records written separately.

## Mastercard A2A

- OAuth 1.0a RSA-SHA256 signing
- Webhook reconciliation: `POST /api/webhook/mastercard`
- Status check: `GET /api/voucher/payment/status/:paymentId`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [br3eze-code](https://github.com/br3eze-code)
- **Source:** [br3eze-code/br3eze-code](https://github.com/br3eze-code/br3eze-code)
- **License:** Apache-2.0
- **Homepage:** https://br3eze.africa

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-br3eze-code-br3eze-code-finance
- Seller: https://agentstack.voostack.com/s/br3eze-code
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
