Awesome Tools

Awesome Tools Agent API

The Agent API from Awesome Tools — 1 operation(s) for agent.

Documentation GitHub OpenAPI

Operations 2

GET /api/agent/submissions Read listing requirements and the current submission JSON Schema #

POST /api/agent/submissions Submit tool #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/awesome-tools:awesome-tools-agent-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  description: Public software listing intake. Validate with dryRun=true before submitting. Submissions save an agent request and screen the site. The API does not publish a listing immediately, edit a product website, or complete payment. Read statusUrl for the verdict.
  title: Awesome Tools Submission Agent API
  version: 1.0.0
tags:
- name: Agent
paths:
  /api/agent/submissions:
    get:
      operationId: getSubmissionRequirements
      responses:
        '200':
          description: Requirements and input schema. No submission is created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmissionRequirements'
      summary: Read listing requirements and the current submission JSON Schema
      tags:
      - Agent
    post:
      description: Set dryRun=true for side-effect-free validation. Real submissions are marked as bots and save an intake brief. Newsletter opt-in defaults to false. The request body must be at most 16 KiB.
      operationId: submitTool
      responses:
        '200':
          description: Submission created or preview.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmissionCreated'
      tags:
      - Agent
      summary: Submit tool
      x-summary-source: derived
components:
  schemas:
    SubmissionRequirements:
      additionalProperties: true
      examples:
      - botBrief:
          botBudget: Budget and currency for listing or promotion options.
          botGoals: Your owner's goals and target audience.
          botInstructions: Instructions, preferences, and limits stored with the submission.
          botListingPlans: Where else you plan to get listed.
          followUp: Briefs are stored on the site.
          limits:
            botBudget: 200
            botGoals: 1000
            botInstructions: 2000
            botListingPlans: 1000
        defaults:
          dryRun: false
          isBot: true
          newsletterOptIn: false
          submitterNote: ''
        dryRun: Set dryRun to true to validate without storing a submission.
        endpoint: https://awesome.tools/api/agent/submissions
        formUrl: https://awesome.tools/submit
        listingOptions:
          free:
            amount: 0
            backlinkHtml: <a href="https://awesome.tools">Awesome Tools</a>
            backlinkTarget: https://awesome.tools
            currency: USD
            instructions: Publish a visible, regular link to Awesome Tools on your homepage.
            requiresBacklink: true
          paid:
            amount: 49
            billing: one-time
            currency: USD
            instructions: Open nextActionUrl for the optional $49 USD Featured Launch checkout.
            newsletterSponsorAmount: 149
            newsletterSponsorOriginalAmount: 249
            newsletterSponsorSavings: 100
            originalAmount: 99
            requiresBacklink: false
            savings: 50
        partnersUrl: https://awesome.tools/partners
        requiredFields:
        - name
        - websiteUrl
        - submitterName
        - submitterEmail
        skillUrl: https://awesome.tools/SKILL.md
      type: object
    SubmissionCreated:
      properties:
        dryRun:
          const: false
        listing:
          additionalProperties: false
          properties:
            botRequestReceived:
              type: boolean
            isFeatured:
              type: boolean
            name:
              type: string
            slug:
              type: string
            status:
              description: Draft listings are not public.
              type: string
          required:
          - botRequestReceived
          - isFeatured
          - name
          - slug
          - status
          type: object
        nextActionUrl:
          format: uri
          type: string
        statusUrl:
          format: uri
          type: string
        success:
          const: true
      required:
      - success
      - dryRun
      - listing
      - nextActionUrl
      - statusUrl
      type: object
externalDocs:
  description: Submission instructions
  url: https://awesome.tools/SKILL.md