Buttondown MCP by usefulapi: tool descriptions scored io.usefulapi/buttondown

tools/list taken: 2026-11-02 (UTC)
From: Official MCP Registry
Connected to: https://buttondown.usefulapi.io/mcp
Homepage: usefulapi.io/buttondown/
Repository: github.com/m190/usefulapi-mcp
Scoring rules: v2
Removal: support@forecall.dev

Scores, issues and names only

This page shows how Buttondown MCP by usefulapi (io.usefulapi/buttondown)'s tool descriptions scored, the issues found and the names of its tools and parameters. The descriptions are the server's own: read them where the copy came from.

Forecall asked the URL this server lists in the official MCP Registry for its tools/list once, on the date above, without calling any tool. The server may have changed since.

servers/io.usefulapi/buttondown

Average score: 48.3 / 100Cloudy
Tools: 25
Near-identical descriptions: 1

Across the server

Tools whose descriptions are nearly the same

1 of 1 pairs shown, highest description similarity first.
Tool	Tool	Description similarity	Name similarity
buttondown_get_automation	buttondown_get_automation_analytics	0.36	0.75

Tools

buttondown_list_segments

40 / 100Cloudy

Purpose: 13 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
No `required` list, so every argument is optional.no_required
Minor
Says nothing about what it returns.no_return_info

buttondown_get_automation_analytics

41 / 100Cloudy

Purpose: 6 / 20
When to use: 0 / 20
Arguments: 23 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 5 / 10

Major
The description only restates the name (9 words).restates_name
Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Its description is nearly the same as buttondown_get_automation's (similarity 0.36); only the names and schemas tell them apart. Say in this description when to use buttondown_get_automation instead.confusable_pair
Minor
Says nothing about what it returns.no_return_info
Minor
Required identifiers whose description does not say where the value comes from: automation_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

buttondown_get_subscriber

44 / 100Cloudy

Purpose: 14 / 20
When to use: 0 / 20
Arguments: 23 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Says nothing about what it returns.no_return_info

buttondown_get_tag_analytics

44 / 100Cloudy

Purpose: 14 / 20
When to use: 0 / 20
Arguments: 23 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Says nothing about what it returns.no_return_info

buttondown_list_events

44 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
No `required` list, so every argument is optional.no_required
Minor
The description mentions none of its 3 or more arguments.params_not_in_description
Minor
Says nothing about what it returns.no_return_info

buttondown_list_forms

44 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
No `required` list, so every argument is optional.no_required
Minor
Says nothing about what it returns.no_return_info

buttondown_list_snippets

44 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
No `required` list, so every argument is optional.no_required
Minor
Says nothing about what it returns.no_return_info

buttondown_list_survey_responses

44 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
No `required` list, so every argument is optional.no_required
Minor
The description mentions none of its 3 or more arguments.params_not_in_description
Minor
Says nothing about what it returns.no_return_info

buttondown_list_tags

44 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
No `required` list, so every argument is optional.no_required
Minor
Says nothing about what it returns.no_return_info

buttondown_get_account

46 / 100Cloudy

Purpose: 14 / 20
When to use: 0 / 20
Arguments: 25 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Says nothing about what it returns.no_return_info

buttondown_list_emails

47 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
No `required` list, so every argument is optional.no_required
Minor
Says nothing about what it returns.no_return_info

buttondown_list_surveys

47 / 100Cloudy

Purpose: 13 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 7 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
No `required` list, so every argument is optional.no_required

buttondown_add_subscriber

49 / 100Cloudy

Purpose: 20 / 20
When to use: 5 / 20
Arguments: 17 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Minor
Arguments without a description: utm_source, utm_medium, utm_campaign.param_no_description
Minor
Says nothing about what it returns.no_return_info

buttondown_get_automation

49 / 100Cloudy

Purpose: 14 / 20
When to use: 0 / 20
Arguments: 23 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 5 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Its description is nearly the same as buttondown_get_automation_analytics's (similarity 0.36); only the names and schemas tell them apart. Say in this description when to use buttondown_get_automation_analytics instead.confusable_pair
Minor
Says nothing about what it returns.no_return_info
Minor
Required identifiers whose description does not say where the value comes from: automation_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

buttondown_get_email

49 / 100Cloudy

Purpose: 14 / 20
When to use: 0 / 20
Arguments: 23 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 5 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Says nothing about what it returns.no_return_info
Minor
Required identifiers whose description does not say where the value comes from: email_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

buttondown_get_email_analytics

49 / 100Cloudy

Purpose: 14 / 20
When to use: 0 / 20
Arguments: 23 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 5 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Says nothing about what it returns.no_return_info
Minor
Required identifiers whose description does not say where the value comes from: email_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

buttondown_get_newsletter

49 / 100Cloudy

Purpose: 14 / 20
When to use: 0 / 20
Arguments: 23 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 5 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Says nothing about what it returns.no_return_info
Minor
Required identifiers whose description does not say where the value comes from: newsletter_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

buttondown_update_email_draft

49 / 100Cloudy

Purpose: 20 / 20
When to use: 5 / 20
Arguments: 12 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 5 / 10

Major
Arguments without a description: subject, description, slug, canonical_url, image.param_no_description
Minor
Says nothing about what it returns.no_return_info
Minor
Required identifiers whose description does not say where the value comes from: email_id. Name the tool or the place that returns it, or models look it up first.id_source_missing

buttondown_list_automations

50 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 0 / 15
Constraints and side effects: 10 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
No `required` list, so every argument is optional.no_required
Minor
Says nothing about what it returns.no_return_info

buttondown_list_newsletters

52 / 100Cloudy

Purpose: 20 / 20
When to use: 5 / 20
Arguments: 20 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Minor
No `required` list, so every argument is optional.no_required
Minor
Says nothing about what it returns.no_return_info

buttondown_list_subscribers

52 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 5 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
No `required` list, so every argument is optional.no_required
Minor
Says nothing about what it returns.no_return_info

buttondown_list_webhooks

52 / 100Cloudy

Purpose: 20 / 20
When to use: 5 / 20
Arguments: 20 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Minor
No `required` list, so every argument is optional.no_required
Minor
Says nothing about what it returns.no_return_info

buttondown_create_tag

55 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 23 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 5 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Says nothing about what it returns.no_return_info

buttondown_update_subscriber

58 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 23 / 25
Return value: 0 / 15
Constraints and side effects: 10 / 10
Examples: 5 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Says nothing about what it returns.no_return_info

buttondown_create_email_draft

65 / 100Cloudy

Purpose: 20 / 20
When to use: 10 / 20
Arguments: 23 / 25
Return value: 0 / 15
Constraints and side effects: 7 / 10
Examples: 5 / 10

Minor
Says nothing about what it returns.no_return_info

What static scoring cannot tell

This score reads only the text of each description and schema: it says what is written, not what a model will do. Short tools whose names already say what they do, such as browser_close, score low here even when models use them well, and in our measurements current models chose the right tool in one step even from one-line descriptions, as long as the names and schemas differed. What the text cannot show, such as what happens over several steps and whether an added sentence helps or misleads, is what an evaluation measures, on the Pro and Team plans.

Is your server listed here and you would rather it were not? Email support@forecall.dev, and we will take it off within 7 days.

All scored servers