Repository navigation
feat: stdio MCP tool docs say when to use each tool and what omitting an input does - #49
Merged
Merged
Conversation
… what omitting it does Descriptions only; no schema, validation or behaviour change. Every tool now states its purpose, when to use it and what it returns; every input states its meaning, where the value comes from, an example and what leaving it out does. Claims checked against the tracking API (click needs ?aff= or ?via=, refund amounts add up to the sale amount, a retry with the same amount is ignored). Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Codex r1: the SDK click call carries no program scope, so the API cannot refuse another program's click id here; tell agents to send only their own. A v2 sale answers 400 to a refund amount of 0; a full refund leaves it out. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Rewrites the tool and input descriptions of
@affitor/mcp(stdio). No schema, validation or behaviour change.?aff=(or?via=) and returnsclick_id,partner_code,cookie_window_days; a refund amount adds to earlier refunds up to the sale amount, a retry with the same invoiceId and amount is ignored, and a full refund leaves the amount out (a v2 sale answers 400 to 0).Why
Glama grades each tool on purpose, usage guidance and parameter meaning, and the awesome-mcp-servers listing waits on a Glama server entry for this repo. The hosted server got the same treatment in affiliate-cms#596.
Checks
vitest: 20/20.tools/listwithAFFITOR_MCP_WRITE=1: 7 tools, every description has a usage line and is at most 400 characters, every input has a description.🤖 Generated with Claude Code