submit_tool
Send a software tool to the Altimateguide directory for editorial review; submissions are queued as pending and are never published automatically.
Instructions
Submit a tool to the Altimateguide directory for editorial review (POST /api/agent/submit). The listing is queued as pending and is never published automatically — an editor reviews it. Categories are optional; unknown/empty categories are recorded for the reviewer. Requires a token (run complete_login, or set ALTIMATEGUIDE_AGENT_TOKEN).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"url": "<url>"
},
"name": "submit_tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Canonical http(s) URL of the tool | |
| cons | No | Short editorial cons | |
| name | Yes | Tool name | |
| pros | No | Short editorial pros | |
| proof | No | Inclusion path (default none). sayabout (Wall of Love URL, recommended) and badge need verificationUrl. For a paid (dofollow) listing use upgrade_listing. | |
| source | No | Origin id, e.g. agent:mcp | |
| pricing | No | Starting price (USD) | |
| features | No | Structured feature list (label + optional detail) | |
| freePlan | No | Offers a free plan | |
| resubmit | No | Set true to send a fresh copy after a previous submission for this URL was rejected. Mints a new idempotency key so the reviewer gets a new row instead of a replay of the rejected one. | |
| freeTrial | No | Offers a free trial | |
| categories | No | Category slugs — call list_categories to get valid ones | |
| externalId | No | Your stable id for idempotent replays; derived from the URL when omitted | |
| description | No | Neutral listing copy (min 20 chars; ranking language is rejected) | |
| verificationUrl | No | Required for sayabout/badge proof | |
| categorySuggestions | No | Free-text category hints when none of the real slugs fit; recorded for the reviewer |