{"openapi":"3.1.0","info":{"title":"Can Agents Use Agent API","version":"2026-06-07","description":"Read-only catalog API for agents searching for agent-friendly software tools."},"servers":[{"url":"https://canagentsuse.com"}],"paths":{"/api/agent/catalog":{"get":{"summary":"Get the full agent-readable catalog","operationId":"getAgentCatalog","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentCatalog"}}}}}}},"/api/agent/search":{"get":{"summary":"Search agent-friendly tools","operationId":"searchAgentTools","parameters":[{"name":"q","in":"query","required":false,"description":"Free text query","schema":{"type":"string","maxLength":120}},{"name":"category","in":"query","required":false,"description":"Category slug filter","schema":{"type":"string","maxLength":80}},{"name":"capability","in":"query","required":false,"description":"Capability slug filter","schema":{"type":"string","maxLength":80}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"1-based result page. Defaults to 1."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10},"description":"Results per page. Defaults to 10 and maxes at 50."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSearchResult"}}}}}}},"/api/agent/tools/{slug}":{"get":{"summary":"Get one tool by slug","operationId":"getAgentTool","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","maxLength":80,"enum":["stripe","github","terraform","cloudflare","playwright","openai","anthropic","firecrawl","kubernetes","shopify","salesforce","netlify","supabase","docker","pulumi","planetscale","twilio","posthog","vercel","google-cloud","algolia","aws","gitlab","microsoft-azure","discord","elasticsearch","lemon-squeezy","neon","railway","render","grafana-cloud","qdrant","replicate","typesense","weaviate","datadog","meilisearch","mongodb-atlas","google-sheets","hugging-face","paddle","upstash","apify","telegram-bot-api","figma","jira","linear","fly-io","postmark","turso","sendgrid","audioserve","bittorrent-tracker","bytebase","calibre","canva","cookcli","dagu","davmail","eclipse-che","gokapi","goploader","gotify","guacamole","jellyfin","lila","linuxgsm","llm-harbor","musikcube","open-meteo","openmediavault","pastefy","pictshare","pyload","rapidbay","rconcli","shellhub","shlink","slskd","snikket","svix","swag-secure-web-application-gateway","sync-in","termix","tipi","webhook-tester","websoft9","xbackbone","zipline","airtable","asana","browserbase","sentry","slack","hubspot","intercom","pipedream","typeform","zendesk","openrouter","trello","activepieces","adguard-home","adminer","algernon","aliasvault","ansible-nas","anycable","apache-airflow","appwrite","asciinema","asterisk","atomic-server","audiobookshelf","auto-mcs","autokitteh","automatisch","awstats","azimutt","ba-kal","baserow","bigcapital","bitmagnet","bitwarden","black-candy","bookbounty","btcpay-server","bunkerweb","caddy","calagopus","calibre-web","centrifugo","changedetection-io","chartbrew","chartdb","chiefonboarding","chitchatter","cloudbeaver","code-server","colanode","composio","conduit","copyparty","corteza","cosmos","countly-community-edition","crafty-controller","cronicle","cronmaster","cyrus-imap","daily-stars-explorer","damselfly","databunker","datasette","davis","diaspora","directus","discount-bandit","dittofeed","django-wiki","docker-mailserver","dockstarter","dokuwiki","domoticz","donetick","dovecot","dreamfactory","easywi","ejabberd","elabftw","emailwiz","ergo","espial","espocrm","evidence","expressa","f-droid","feedcord","feedmixer","ferron","fess","firefox-account-server","flagsmith","flatnotes","flowctl","fossbilling","frappe-helpdesk","fredy","friendica","fusio","galene","gamevault","gaseous-server","gerbera","gitbucket","go-doxy","gocron","gollum","gonic","gossa","gotenberg","graphhopper","graphweaver","grimoire","handbrake-web","haraka","harbor","hasura","healthchecks","heimdall","homarr","home-assistant","homepage-by-gethomepage","homepage-by-tomershvueli","homer","hoppscotch-community-edition","htmly","huginn","hyperswitch","imgproxy","inspircd","iobroker","iredmail","isso","janus","judge0-ce","kamailio","kavita","kestra","keygen","khoj","kibitzr","koel","komga","kong","kottster","lazylibrarian","leon","libre-translate","linkace","lowdefy","luanti","lura","lyrion-music-server","maddy-mail-server","mail-in-a-box","mailcow","mailu","maloja","mastodon","matchering","mathesar","mautic","mediacms","mediamtx","meelo","meshcentral","mindsdb","minthcm","misskey","mistral-ai","mistserver","mongooseim","mopidy","mstream","myfin-budget","mylar3","n8n","navidrome-music-server","nextcloud","nginx","nginx-proxy-manager","ngircd","nocodb","node-red","nominatim","notifo","olivetin","omeka","omeka-s","onlyoffice","open-source-routing-machine-osrm","open-webui","openfire","openhab","openmeetings","opensearch","opensips","opensmtpd","opentrashmail","opik","ossn","outline-server","ovenmediaengine","owncast","pangolin","para","part-db","passbolt","pelican-panel","photoview","pigallery-2","pinepods","piqueserver","plugnmeet","pomerium","postal","prestashop","privatebin","pterodactyl","pufferpanel","pushbits","pydio","radicale","reaparr","restreamer","retrom","revive-adserver","routr","rss-monster","rstudio-server","rudderstack","sabredav","safeline","saltcorn","sandstorm","scoold","screego","searxng","seaweedfs","seerr","self-host-blocks","sentry-self-hosted","sftpgo-community-edition","shaarli","shelf","simple-nixos-mailserver","snapcast","specifically-clementines","spree-commerce","srs","stackstorm","stalwart-mail-server","startos","stash","static-web-server","strapi","stump","supysonic","swingmusic","synapse","syncloud","tagspaces","tasmota","teampass","technitium-dns-server","teleport","tigase","tileserver-gl","traefik","traggo","trailbase","tubesync","tududi","tuwunel","tyk","ui-bakery","umbrel","unrealircd","uusec-waf","vaultwarden","wakapi","wanderer","weblate","wger","wiki-go","wikidocs","wildduck","xandikos","xsrv","yacy","yarr","ydl-api-ng","yourls","youtarr","youtubedl-server","zenko-cloudserver","zoraxy","zot-oci-registry","streamer","task","cloudinary","cohere","google-gemini","notion","pinecone","segment","amplitude","exa","groq","together-ai","uploadthing","zapier","resend","clerk","mailgun","alf-io","bitpoll","bracket","christmas-community","claper","clearflask","docassemble","fider","formbricks","gathio","heyform","hi-events","hitobito","limesurvey","opnform","adventurelog","booklogr","chyrp-lite","cloudlog","ech0","fx","genea-app","genealogy","geneweb","ghost","haven","jetlog","known","lubelogger","mataroa","open-archiver","pluxml","serendipity","simplelogin","siyuan","wavelog","webtrees","writefreely","015","bentopdf","chibisafe","clipcascade","converse-js","cypht","egroupware","element","enclosed","fasten-health","files-sharing","gitit","goaccess","group-office","hatsu","invoice-ninja","itflow","joplin","kiwi-irc","livecodes","lobehub","local-content-share","miniserve","mpd","ntfy","onionshare","openziti","ownfoil","peergos","picoshare","picsur","plik","projectsend","psitransfer","qbittorrent","quassel-irc","quickshare","red-eclipse-2","roundcube","safebucket","sharry","slink","snappymail","starbase-80","the-lounge","tinode","tinyfeed","transfer-sh","transmission","uguu","uvdesk","vod2pod-rss","warpgate","webtor","weechat","wetty","yopass","2fauth","4ga-boards","a-dark-room","accent","activitywatch","actual","admidio","affine-community-edition","agenta","aimeos","airtrail","akaunting","aleph","ampache","anchr","anonaddy","answer","anubis","anythingllm","apache-solr","apaxy","apostrophe","appflowy","apprise","appsmith","aptabase","archivebox","archivesspace","artalk","atheos","automad","azuracast","baby-buddy","backdrop-cms","bagisto","bar-assistant","beaver-habit-tracker","beelzebub","beets","bencher","bewcloud","bigbluebutton","bin","bitcart","blinko","blocky","bludit","bluecherry","bolt-cms","bookwyrm","bubo-reader","buddypress","budibase","buffer","bugsink","bugzilla","buku","bytestash","cal-diy","calibre-web-automated","canary-tokens","canvas-lms","casaos","chamilo-lms","channeltube","chatwoot","chevereto","chhoto-url","chirpy","chronoframe","ckan","cloudreve","cncjs","cockpit","coder","collective-access-providence","commafeed","concrete-5-cms","contao","convertx","coral","coreshop","couchcms","craftcms","cryptpad","cups","cyberchef","cytube","dailytxt","dashy","databag","dawarich","ddracenetwork","debops","deleterr","dietpi","dify-ai","directory-lister","discourse","django-crm","docat","docmost","docs","docspell","documenso","documize","docuseal","dolibarr","domain-locker","domjudge","downtify","dpaste","dragonfly","draw-io","drop","druid","dspace","easy-appointments","eigenfocus","elgg","emqx","enigma-1-2-bbs","ente","erpnext","erxes","etherpad","evcc","ever-gauzy","evershop","everydocs","expenseowl","ezbookkeeping","family-accounting-tool","farmos","fava","featbit","fedora-commons-repository","feedpushr","feeds-fun","filebrowser","filegator","filerise","filestash","firefly-iii","firezone","fittrackee","flarum","flipt","flowforge","fluidd","flyimg","focalboard","foodsoft","forward-email","frappe-hr","freescout","freeswitch","freshrss","frigate","fusion","fusionpbx","gameyfin","ganymede","gerrit","ghostfolio","gibbon","gitea","gladys","glance","globaleaks","glowing-bear","go-feature-flag","goatcounter","gogs","google-webfonts-helper","grist","grocy","habitica","halo","hamsterbase-tasks","headphones","hedgedoc","hemmelig","hister","homebox-sysadminsmedia","homegallery","homelabos","hortusfox","huly","humhub","hypersomnia","hyphanet","i-librarian","ifm","ihatemoney","ilias","imgcompress","immich","immich-kiosk","indico","infisical-community-edition","inginious","inventaire","inventree","invidious","invoiceplane","invoiceshelf","iodine","isponsorblocktv","it-tools-by-sharevb","jelu","jitsi-meet","jitsi-video-bridge","joomla","jotty","jupyterlab","kanboard","kaneo","kapowarr","karakeep","karaoke-eternal","keila","keystonejs","kill-bill","kimai","kinto","kirby","kiwix-serve","kodi","koha","koillection","krayin","kresus","kriss-feed","kutt","kyoo","lago","lancache","langfuse","languagetool","leafwiki","leantime","ledgersmb","leed","lemmy","librebooking","librechat","libredesk","librephotos","libretime","lidarr","lidatube","lidify","linkding","linkstack","linkwarden","listmonk","litlyx","littlelink","live-helper-chat","livebook","lms","local-deep-research","localai","loomio","lychee","mafl","magento-open-source","mail-archiver","mainsail","manage-my-damn-life","manifest","manticore-search","mantisbt","many-notes","manyfold","matomo","mattermost","mayan-edms","maza-ad-blocking","mealie","medama-analytics","medusa","medusajs","meme-search","memos","mere-medical","metabase","metube","microweber","middleware","mikochi","mindustry","miniflux","mirotalk-c2c","mirotalk-p2p","mirotalk-sfu","misago","modoboa","modx","monetr","monica","moode-audio","mosparo","motioneye","movary","movim","mox","mta-sa","multi-scrobbler","mumble","mybb","mycart","mycorrhiza-wiki","myip","myspeed","mytube","nefarious","neko","neonlink","netalertx","netron","newsblur","nextcloud-memories","nextcloudpi","nodebb","note-mark","novu","nullboard","nymphcast","october","octobot","octobox","octoprint","ocular","odoo","ofbiz","offen","ollama","ombi","omnitools","one-time-secret","onyx-community-edition","open-food-network","open-source-pos","openbudgeteer","opencart","opencloud","openemr","opengist","openhabittracker","openolat","openproject","openreader","openremote","openrouteservice","opensign","openslides","openstreetmap","opentripplanner","openttd","operational-co","osem","otobo","ots","otter-wiki","outline","overleaf","owncloud","owntracks-recorder","paaster","paperless-ngx","papermerge","papra","password-pusher","payload-cms","pdfding","peertube","penpot","personal-management-system","photofield","photoprism","phpbb","phplist","pi-hole","piler","pimcore","pinchflat","piwigo","pixelfed","plainpad","plane","planka","plausible-analytics","pocketbase","podfetch","polaris","posio","postiz","pretalx","pretix","publify","puter","qloapps","qpixel","radarr","rallly","raneto","razzia","reactive-resume","reader","readflow","recipesage","recipya","redash","redaxo","redlib","rei3","relate","remark42","request-tracker","retroshare","revealjs","review-board","rocket-chat","romm","rss-bridge","rss2email","rsshub","rustypaste","rybbit","ryot","saleor","scribble-rs","seafile","seatsurfing","selfoss","send","servas","shaper","sharetribe","shhh","shiori","shipshipship","shkeeper","shopware-community-edition","sigal","signature-pdf","silverbullet","simple-machines-forum","simplex-chat","sip-irrigation-control","sipcapture-homer","sish","sist2","slash","socialhome","socioboard","sogo","solidinvoice","solidtime","solidus","sonarr","sourcebans","spectrum-2","speed-test-by-openspeedtest","speedtest-tracker","spoolman","sqlpage","squidex","sshwifty","standard-notes","statistics-for-strava","stirling-pdf","stoat","stretto","string-is","stringer","strix","suitecrm","sunshine","sup3rs3cretmes5age","super-productivity","superdesk","superset","sure","suroi","sylius","sympa","syncthing","synctube","talkyard","tandoor-recipes","tasks-md","teammapper","teslamate","textpattern","the-battle-for-wesnoth","thelia","thingsboard","thumbor","tiddlywiki","tiledesk","timetagger","tiny-file-manager","tiny-tiny-rss","tinyproxy","titra","tolgee","tooljet","tox","tracim","tracks","traduora","triliumnext-notes","trip","tube-archivist","twenty","typebot","typemill","typo3","umami","umbraco","unison","untrusted","upsnap","upvote-rss","url-to-png","usertour","vane","veloren","vendure","vikunja","vince","viseron","vouchervault","vvveb-cms","wagtail","wallabag","wallos","warracker","wastebin","watcharr","watchyourlan","wayback","wbo","websurfx","webthings-gateway","weewx","wekan","wiki-js","wingfit","wintercms","wishlist","wondercms","woocommerce","wordpress","workadventure","writing","wygiwyh","xwiki","yamtrack","your-spotify","yt-dlp-web-ui","zammad","zenphoto","zentao","zero-k","ziit","zim","zincsearch","znc","zoneminder","zulip","x-api","oxid-eshop"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentToolEnvelope"}}}},"404":{"description":"Tool not found"}}}}},"components":{"schemas":{"AgentCatalog":{"type":"object","required":["site","tools","categories","capabilities","useCases"],"properties":{"site":{"type":"object"},"tools":{"type":"array","items":{"$ref":"#/components/schemas/AgentTool"}},"categories":{"type":"array","items":{"type":"object"}},"capabilities":{"type":"array","items":{"type":"object"}},"useCases":{"type":"array","items":{"type":"object"}}}},"AgentSearchResult":{"type":"object","required":["query","category","capability","page","limit","count","total","totalPages","hasMore","tools"],"properties":{"query":{"type":"string"},"category":{"type":"string"},"capability":{"type":"string"},"page":{"type":"integer"},"limit":{"type":"integer"},"count":{"type":"integer"},"total":{"type":"integer"},"totalPages":{"type":"integer"},"hasMore":{"type":"boolean"},"tools":{"type":"array","items":{"$ref":"#/components/schemas/AgentTool"}}}},"AgentToolEnvelope":{"type":"object","required":["tool"],"properties":{"tool":{"$ref":"#/components/schemas/AgentTool"}}},"AgentTool":{"type":"object","required":["slug","name","url","websiteUrl","tagline","shortDescription","agentSummary","agentScore","agentTier","scoreBreakdown","categories","capabilities"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"websiteUrl":{"type":"string","format":"uri"},"docsUrl":{"type":["string","null"],"format":"uri"},"githubUrl":{"type":["string","null"],"format":"uri"},"tagline":{"type":"string"},"shortDescription":{"type":"string"},"agentSummary":{"type":"string"},"bestFor":{"type":"string"},"cautionNotes":{"type":["string","null"],"description":"Human and agent-readable limitations, risks, and review requirements for operating this tool."},"pricingSummary":{"type":"string"},"authModel":{"type":"string"},"accountCreation":{"type":"string"},"browserSupport":{"type":"string"},"cliPackage":{"type":["string","null"]},"apiBaseUrl":{"type":["string","null"]},"mcpServer":{"type":["string","null"]},"agentScore":{"type":"integer"},"agentTier":{"type":"string"},"scoreBreakdown":{"type":"object"},"launchScore":{"type":"integer"},"isFeatured":{"type":"boolean"},"categories":{"type":"array","items":{"type":"object"}},"useCases":{"type":"array","items":{"type":"object"}},"capabilities":{"type":"array","items":{"type":"object"}}}}}}}