Submissions

POST/api/v1/submissions

Submit a new service. No auth required. Interface URLs must be on the service's own domain and are fetched during the request — the listing publishes immediately if one answers, or returns 422 with the probe results if none do. Every listing needs an icon: send icon_url or icon_base64, or leave both out and the service's own site is checked for one.

parameters

• name (required)service name
• url (required)service URL
• category (required)category id from /categories
• description (required)max 120 chars
• auth_methodapi-key, m2m-oauth, bot-token, wallet, x402-none, none
• has_mcp_server, mcp_server_urlMCP server support
• has_openapi_spec, openapi_spec_urlOpenAPI spec support
• accepts_mpp, accepts_x402payment protocol support
• has_skill_file, has_llms_txtintegration files
• billing_modelpay-per-request, subscription, free, etc.
• has_free_tierboolean
• tagsarray of strings
• contact_emailfor verification

example

curl -X POST "https://www.botfriendly.xyz/api/v1/submissions" \
  -H "Content-Type: application/json" \
  -d '{"name":"YourService","url":"https://example.com","category":"browse","description":"What it does"}'