How do I install the Agentfin skill?

Run npx skillmds@latest add dvcrn/agentfin in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Agentfin safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Agentfin?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Agentfin free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Agentfin?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Agentfin by dvcrn — Agent Skill

Name: Agentfin
Rating: 4.5 (4 reviews)
Author: dvcrn

File contents

AgentFin — Virtual Cards for Agents

You have access to the AgentFin API. Use it to check your balance, get virtual card credentials for online purchases, and fetch OTP codes for 3DS verification.

Authentication

All requests require a Bearer token. Use the AGENTFIN_API_KEY environment variable.

Authorization: Bearer $AGENTFIN_API_KEY

Base URL: https://agentfin.tech/api

Endpoints

Check Balance & Card Status

curl -H "Authorization: Bearer $AGENTFIN_API_KEY" \
  https://agentfin.tech/api/me

Response includes balance (USD string), card object with maskedPan and status, and depositAddress for USDT top-ups.

Get Card Credentials (for online purchases)

curl -H "Authorization: Bearer $AGENTFIN_API_KEY" \
  https://agentfin.tech/api/cards/{cardId}/sensitive

Returns pan, cvv, expiryMonth, expiryYear, cardHolderName, billingAddress. Rate limited to 10 requests/minute.

Important: Use the cardId from the /api/me response (card.cardId field).

Fetch Latest OTP Code (for 3DS verification)

curl -H "Authorization: Bearer $AGENTFIN_API_KEY" \
  https://agentfin.tech/api/inbox/latest-otp

Returns the most recent email with extracted OTP codes. The extractedCodes field is an array of strings. Use the first element as the verification code.

If a purchase triggers 3DS, wait 10-30 seconds for the OTP email to arrive, then call this endpoint.

Top Up Card Balance

curl -X POST -H "Authorization: Bearer $AGENTFIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 50, "currency": "USD"}' \
  https://agentfin.tech/api/cards/{cardId}/topup

Moves funds from your account balance to the card. The card is prepaid — you cannot spend more than the loaded amount.

View Transaction History

curl -H "Authorization: Bearer $AGENTFIN_API_KEY" \
  https://agentfin.tech/api/me/transactions

Returns all deposits, card charges, top-ups, and refunds.

Typical Purchase Flow

Check balance with GET /api/me — ensure sufficient funds
Get card credentials with GET /api/cards/{cardId}/sensitive
Use PAN, CVV, expiry to fill in payment form on merchant site
If 3DS is triggered, wait ~15 seconds then GET /api/inbox/latest-otp
Submit the OTP code from extractedCodes[0]
Purchase complete

Important Notes

The card is prepaid. You cannot spend more than the loaded balance.
Card credentials are rate-limited (10/min). Cache them for the duration of a purchase session.
OTP codes arrive via email to a dedicated inbox. There may be a 10-30 second delay.
Fund the account by sending USDT (TRC20) to the deposit address from GET /api/me.

---name: agentfindescription: Issue virtual Visa/MC cards funded by USDT. Check balance, get card credentials, fetch OTP codes — all via REST API.---# AgentFin — Virtual Cards for AgentsYou have access to the AgentFin API. Use it to check your balance, get virtual card credentials for online purchases, and fetch OTP codes for 3DS verification.## AuthenticationAll requests require a Bearer token. Use the `AGENTFIN_API_KEY` environment variable.```Authorization: Bearer $AGENTFIN_API_KEY```Base URL: `https://agentfin.tech/api`## Endpoints### Check Balance & Card Status```bashcurl -H "Authorization: Bearer $AGENTFIN_API_KEY" \ https://agentfin.tech/api/me```Response includes `balance` (USD string), `card` object with `maskedPan` and `status`, and `depositAddress` for USDT top-ups.### Get Card Credentials (for online purchases)```bashcurl -H "Authorization: Bearer $AGENTFIN_API_KEY" \ https://agentfin.tech/api/cards/{cardId}/sensitive```Returns `pan`, `cvv`, `expiryMonth`, `expiryYear`, `cardHolderName`, `billingAddress`. Rate limited to 10 requests/minute.**Important:** Use the `cardId` from the `/api/me` response (`card.cardId` field).### Fetch Latest OTP Code (for 3DS verification)```bashcurl -H "Authorization: Bearer $AGENTFIN_API_KEY" \ https://agentfin.tech/api/inbox/latest-otp```Returns the most recent email with extracted OTP codes. The `extractedCodes` field is an array of strings. Use the first element as the verification code.If a purchase triggers 3DS, wait 10-30 seconds for the OTP email to arrive, then call this endpoint.### Top Up Card Balance```bashcurl -X POST -H "Authorization: Bearer $AGENTFIN_API_KEY" \ -H "Content-Type: application/json" \ -d '{"amount": 50, "currency": "USD"}' \ https://agentfin.tech/api/cards/{cardId}/topup```Moves funds from your account balance to the card. The card is prepaid — you cannot spend more than the loaded amount.### View Transaction History```bashcurl -H "Authorization: Bearer $AGENTFIN_API_KEY" \ https://agentfin.tech/api/me/transactions```Returns all deposits, card charges, top-ups, and refunds.## Typical Purchase Flow1. Check balance with `GET /api/me` — ensure sufficient funds2. Get card credentials with `GET /api/cards/{cardId}/sensitive`3. Use PAN, CVV, expiry to fill in payment form on merchant site4. If 3DS is triggered, wait ~15 seconds then `GET /api/inbox/latest-otp`5. Submit the OTP code from `extractedCodes[0]`6. Purchase complete## Important Notes- The card is **prepaid**. You cannot spend more than the loaded balance.- Card credentials are rate-limited (10/min). Cache them for the duration of a purchase session.- OTP codes arrive via email to a dedicated inbox. There may be a 10-30 second delay.- Fund the account by sending USDT (TRC20) to the deposit address from `GET /api/me`.

Frequently asked questions

Agentfin