AIMYTOOL owner-agent protocol

One skill. A complete listing.

Give a site owner agent the context it needs to collect, validate, submit, and track a high-quality AI tool listing without back-and-forth.

ProtocolREST + JSON
AuthPublic + private token
ReviewHuman editorial
Rate limit5 submissions / day
The workflow

Three steps, one source of truth.

The skill and public form both produce the same normalized record, so editors can evaluate every listing consistently.

01

Collect

Inspect the official product site, pricing page, and help center. Never invent metrics, features, or customer claims.

02

Prepare

Normalize the category, pricing model, platforms, features, and audience into the required JSON schema.

03

Submit + track

Send one request, store the private token securely, and poll the status endpoint only when a review update is expected.

Quick start

Install the skill, then let the agent do the detail work.

The package contains the submission skill, a field-by-field quality guide, a dependency-free Node.js client, and the free-submission backlink requirement.

aimytool-submission/Version 1.0 | Agent Skills format
SKILL.mdreferences/api.mdreferences/field-guide.mdscripts/submit-tool.mjsscripts/check-status.mjs
No external dependenciesWorks with any agent shell
Direct API

A small surface area, designed for review.

The endpoint validates completeness and stores the response in the same queue as the human form. Approval remains human.

MethodEndpointPurpose
GET/api/v1/tools.phpBrowse approved tools
GET/api/v1/tool.php?slug=chatgptRead a tool profile
POST/api/v1/submissions.phpCreate a review submission
GET/api/v1/submissions.php?id=...&token=...Check private status
Submit a listing
curl -X POST https://aimytool.com/api/v1/submissions.php \
  -H "Content-Type: application/json" \
  -H "X-AIMYTOOL-Agent: site-owner-agent/1.0" \
  -d @listing.json
Check status
curl "https://aimytool.com/api/v1/submissions.php?id=sub_xxx&token=private_token"
202 AcceptedStore the token before showing the result.
Response
{
  "data": {
    "submission_id": "sub_5c2f...",
    "status": "pending",
    "status_url": "https://aimytool.com/status/?id=...&token=...",
    "edit_token": "shown_once",
    "completeness_score": 94
  }
}
Payload contract

Required fields

A submission missing any required field is rejected with a machine-readable field error response.

FieldTypeRuleDescription
namestring2-120 charsProduct name
urlURLPublic HTTPS URLOfficial product website
taglinestring20-180 charsOutcome-focused one-line pitch
descriptionstring200-4000 charsProduct and workflow detail
what_it_doesstring120-5000 charsDetailed public page explanation
helps_usersstring80-5000 charsConcrete user outcomes
categoryenumCategory slugPrimary category
pricing_modelenumfree|freemium|paid|contactPublic pricing model
key_featuresstring[]3-8 itemsConcrete capabilities
use_casesstring[]2-8 itemsSpecific jobs to be done
faqsobject[]3-10 itemsQuestion and answer pairs
who_forstring20-500 charsBest-fit audience
owner_namestring2-120 charsAuthorized submitter
owner_emailemailValid emailContact for review
friendly_link_urlURLRequired for freePage containing your AIMYTOOL link
friendly_link_typeenumfooter|blog|otherLocation of the link
consent_accuracybooleantrueAccuracy declaration
consent_termsbooleantrueListing terms acceptance
Optional fields
logo_urlsecondary_categoriesstarting_pricefree_trialplatformslaunch_yearnot_forintegrationslanguagesowner_rolex_profiledemo_urlconsent_contact
Bulk operations

Update up to 100 tools in one request.

Create an API key from the editorial dashboard, then send patch, upsert, or hide operations. Batch responses report success or failure per item.

MethodEndpointPurpose
POST/api/batch/v1/tools.phpCreate, patch, or hide tools
Batch tool update
curl -X POST https://aimytool.com/api/batch/v1/tools.php \
  -H "Authorization: Bearer aimy_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "action": "patch",
        "slug": "example-tool",
        "tagline": "Updated one-line pitch",
        "localizations": {
          "en": { "tagline": "...", "seo_title": "...", "seo_description": "...", "what_it_does": "...", "helps_users": "...", "faqs": [] }
        }
      }
    ]
  }'
Submission policy

What the agent must not do

Invent signals

Do not fabricate user counts, funding, awards, ratings, or customer logos.

Poll aggressively

Check status no more than once per hour. A human review usually takes two business days.

Bypass ownership

Submit only products the owner is authorized to represent. Public listings still require editorial approval.

Ready to connect

Give your agent the full submission brief.

Download the skill folder, copy it into your agent's skills directory, and provide the product URL and owner contact.

Download skillCheck a status