Tools
Everything Jami exposes to your AI client: tools, resources and prompts.
Tool docs quality: C — 9 tools graded
Average 58/100 for how clearly each description tells an AI client what the tool does, what it needs, and what it changes. It is not a security audit.
- Grade A: 0
- Grade B: 3
- Grade C: 3
- Grade D: 3
- Grade F: 0
Charge a product (p… token or id) or any amount (amountminor + description). With gateway: pushes the prompt to the buyer's phone. Without: returns a Jami payment link to send them.
Description quality grade C, 60/100 · 3 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: passed20/20
Length is in a useful range.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: passed20/20
The description mentions what the tool takes.
- Explains side effects: not passed0/15
This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
Build a correctly signed test event, and optionally POST it to your local handler.
Description quality grade B, 75/100 · 2 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: passed20/20
Length is in a useful range.
- Starts with what it does: passed15/15
Opens with an action verb.
- Mentions its inputs: passed20/20
The description mentions what the tool takes.
- Explains side effects: not passed0/15
This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
Pay out to Telebirr, M-Pesa or CBE Birr. Opt-in (see Safety).
Description quality grade D, 40/100 · 4 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: passed20/20
Length is in a useful range.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: not passed0/15
This looks like a write action. Say what changes, and whether it can be undone.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
jami_get_balancetoolWithdrawable earnings and whether the org can withdraw.
Description quality grade D, 45/100 · 4 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: not passed10/20
A bit terse. One more clause about inputs or results would help.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
Check a session once, with the failure reason when it expired.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: passed20/20
Length is in a useful range.
- Starts with what it does: passed15/15
Opens with an action verb.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
jami_list_orderstoolOrders, newest first, paginated and filterable by status.
Description quality grade D, 45/100 · 4 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: not passed10/20
A bit terse. One more clause about inputs or results would help.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
Fee, tax and net for an amount, plus auto-pay and cap checks. Offline.
Description quality grade C, 55/100 · 3 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: passed20/20
Length is in a useful range.
- Starts with what it does: not passed0/15
Open with an action verb, for example “Search issues…” or “Creates a label…”.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
Check a captured delivery's signature, and why it fails.
Description quality grade C, 60/100 · 3 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: not passed10/20
A bit terse. One more clause about inputs or results would help.
- Starts with what it does: passed15/15
Opens with an action verb.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.
Wait for the buyer to finish, with progress updates. Never hangs: returns open at the timeout.
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
The tool has a description an AI client can read.
- Sensible length: passed20/20
Length is in a useful range.
- Starts with what it does: passed15/15
Opens with an action verb.
- Mentions its inputs: not passed0/20
Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
Add when to use it, what it requires, or what to use instead.