Tools
Everything faxforagents-mcp exposes to your AI client: tools, resources and prompts.
Tool docs quality: C — 15 tools graded
Average 59/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: 1
- Grade B: 2
- Grade C: 9
- Grade D: 2
- Grade F: 1
cancel_faxtoolRequest cancellation of one outbound fax.
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: 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: 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.
extract_fax_datatoolStart or retrieve OCR and optional structured field extraction for one received fax or document.
Description quality grade A, 90/100 · 1 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: 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.
get_fax_balancetoolRead available and held wallet funds in the credential's environment.
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.
Read account limits, routes, formats, prices and credential scopes.
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.
get_fax_documenttoolRead one fax document and its page previews.
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.
get_fax_statustoolRead one outbound fax's delivery state and attempts.
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.
get_guidetoolRead the Fax for Agents manual and tool workflow.
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.
Read the human approval decision for one review request.
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.
list_faxestoolList outbound faxes your organization sent, newest first.
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.
list_inboxtoolList received faxes on your organization's numbers, newest first.
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.
prepare_faxtoolCreate a fax document from text, Markdown, HTML or a completed REST upload.
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: 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: 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.
quote_faxtoolPrice one prepared document for one fax destination.
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.
read_inbound_faxtoolRead one received fax with its page count, document reference and available OCR text.
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.
Ask a person to approve a quoted send or help with a fax.
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.
Queue one quoted outbound fax for delivery.
Description quality grade F, 30/100 · 5 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: 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.