docs: add agentic payments docs by stepskop · Pull Request #1981 · apify/apify-docs

stepskop · 2025-10-06T13:51:40Z

Adds a page at /platform/integrations/skyfire. Dedicated to the documentation of agentic payments with Skyfire.
Also mentions the allowsAgenticUsers parameter on API's GET /store.

Based on this Notion document.

Note

Adds Skyfire agentic payments documentation and updates Store Actors API with allowsAgenticUsers filter and isWhiteListedForAgenticPayment field.

API (OpenAPI)
- Add query parameter allowsAgenticUsers (boolean) to GET /store actors listing in apify-api/openapi/paths/store/store.yaml.
- Extend response examples with isWhiteListedForAgenticPayment on actor items.
Docs
- New page sources/platform/integrations/ai/skyfire.md documenting agentic payments via Skyfire:
  - MCP setup and configuration (including ?payment=skyfire and optional actors preload).
  - API usage with skyfire-pay-id header for Actor runs and data retrieval.
  - Limitations and supported-actors filtering using allowsAgenticUsers=true.

^{Written by Cursor Bugbot for commit 906522f. Configure here.}

apify-service-account · 2025-10-06T13:55:14Z

Preview for this PR was built for commit 635be15 and is ready at https://pr-1981.preview.docs.apify.com!

apify-service-account · 2025-10-06T14:00:15Z

Preview for this PR was built for commit 5ed44fe and is ready at https://pr-1981.preview.docs.apify.com!

apify-service-account · 2025-10-06T14:31:13Z

Preview for this PR was built for commit 0e0e768 and is ready at https://pr-1981.preview.docs.apify.com!

apify-service-account · 2025-10-08T13:46:22Z

Preview for this PR was built for commit a6a01c3b and is ready at https://pr-1981.preview.docs.apify.com!

apify-service-account · 2025-10-09T10:16:16Z

Preview for this PR was built for commit 79f472dd and is ready at https://pr-1981.preview.docs.apify.com!

apify-service-account · 2025-10-09T10:19:29Z

Preview for this PR was built for commit 9ecda757 and is ready at https://pr-1981.preview.docs.apify.com!

apify-service-account · 2025-11-03T13:41:40Z

Preview for this PR was built for commit 82964585 and is ready at https://pr-1981.preview.docs.apify.com!

apify-service-account · 2025-11-04T12:43:47Z

Preview for this PR was built for commit fbef6fda and is ready at https://pr-1981.preview.docs.apify.com!

apify-service-account · 2025-11-19T14:48:56Z

Preview for this PR was built for commit 906522fb and is ready at https://pr-1981.preview.docs.apify.com!

janbuchar · 2025-11-19T21:02:54Z

The OpenAPI part (for which I'm a code owner) is fine, but not the important part of the PR - that's why I removed my review request

tobice

Read through the documentation page and honestly, I don't have much to add there. Looks good, ship it 🚀 👍

tobice · 2025-11-20T15:33:40Z

+    - name: allowsAgenticUsers
+      in: query
+      description: |
+        If true, only return Actors that allow agentic users. If false, only


Empty means return all?

stepskop · 2025-11-21T15:02:45Z

I added a diagram of the whole flow to the "How It Works" section.

apify-service-account · 2025-11-21T15:04:42Z

Preview for this PR was built for commit 54a39293 and is ready at https://pr-1981.preview.docs.apify.com!

apify-service-account · 2025-11-21T16:01:21Z

Preview for this PR was built for commit 9b874372 and is ready at https://pr-1981.preview.docs.apify.com!

mhamas

LGTM, couple of small comments to consider.

mhamas · 2025-11-24T10:49:16Z

+
+Agentic payments enable AI agents to autonomously run Apify Actors using third-party payment providers, without requiring traditional Apify user accounts. This allows agents to discover, execute, and pay for web scraping and automation tasks independently.
+
+Currently, Apify supports agentic payments through **Skyfire**, a payment network specifically designed for AI agents.


Nit: I'd smuggle somewhere that more integrations are planned for foreseeable future.

mhamas · 2025-11-24T10:50:27Z

+
+### Configuration
+
+Configure your MCP client to connect to both the Skyfire and Apify MCP servers. When connecting to the Apify MCP server for agentic payments, you must include the `?payment=skyfire` query parameter in the server URL. This enables the agentic payment flow and informs the agent about payment requirements.


Q: do we want to also include this info on mcp.apify.com? So agentic-payment-supported URL can be easily copied from there?

mhamas · 2025-11-24T10:51:50Z

+https://mcp.apify.com?payment=skyfire&tools=actor1,actor2,actor3
+```
+
+Replace `actor1,actor2,actor3` with the actual Actor IDs you want to make available, such as `junglee/free-amazon-product-scraper,streamers/youtube-scraper`.


Suggestion: I'd also refer to the section below on discussion, which Actors are available.

mhamas · 2025-11-24T10:52:48Z

+
+## Using Skyfire with Apify API
+
+For direct API integration, you can use Skyfire PAY tokens to authenticate and pay for Actor runs.


Suggestion: here, I'd stress that the MCP client should do all of this seamlessly behind the scenes. That's the primary and recommended mode of operation. The information here is just for completness if somebody decides they want to try it out directly.

mhamas · 2025-11-24T10:54:13Z

+
+Not all Actors in the Apify Store can be run using agentic payments.
+
+Apify maintains a curated list of Actors approved for agentic payments. To check if an Actor supports agentic payments, use the `allowsAgenticUsers=true` query parameter when [searching the store via API](https://docs.apify.com/api/v2#/reference/store/store-actors-collection/get-list-of-actors-in-store).


Nit: you you maybe directly link the correct URL user can just copy paste?

mhamas

LGTM, couple of small comments to consider.

apify-service-account · 2025-11-24T15:04:41Z

Preview for this PR was built for commit 3a2a5b49 and is ready at https://pr-1981.preview.docs.apify.com!

TC-MO

Few changes made to formatting, some changes for clarity & conciness.
Removed time-anchor in docs
Fixed description
Some questions as well

apify-service-account · 2025-11-27T17:02:16Z

Preview for this PR was built for commit 7a50673f and is ready at https://pr-1981.preview.docs.apify.com!

apify-service-account · 2025-11-27T17:12:39Z

Preview for this PR was built for commit 9a0f0ad2 and is ready at https://pr-1981.preview.docs.apify.com!

apify-service-account · 2025-11-27T17:26:31Z

Preview for this PR was built for commit 892b4656 and is ready at https://pr-1981.preview.docs.apify.com!

apify-service-account · 2025-11-28T09:52:41Z

Preview for this PR was built for commit f60459ed and is ready at https://pr-1981.preview.docs.apify.com!

apify-service-account · 2025-11-28T10:26:24Z

Preview for this PR was built for commit f0f005ee and is ready at https://pr-1981.preview.docs.apify.com!

TC-MO

Few more things, after that we are good to go

apify-service-account · 2025-12-01T10:04:42Z

Preview for this PR was built for commit 7561f33b and is ready at https://pr-1981.preview.docs.apify.com!

Adds a page at `/platform/integrations/skyfire`. Dedicated to the documentation of agentic payments with Skyfire. Also mentions the `allowsAgenticUsers` parameter on API's `GET /store`. Based on [this Notion document](https://www.notion.so/apify/Agentic-Payments-User-documentation-284f39950a22808381d6f5a03c36e024).  --- > [!NOTE] > Adds Skyfire agentic payments documentation and updates Store Actors API with `allowsAgenticUsers` filter and `isWhiteListedForAgenticPayment` field. > > - **API (OpenAPI)** > - Add query parameter `allowsAgenticUsers` (boolean) to `GET /store` actors listing in `apify-api/openapi/paths/store/store.yaml`. > - Extend response examples with `isWhiteListedForAgenticPayment` on actor items. > - **Docs** > - New page `sources/platform/integrations/ai/skyfire.md` documenting agentic payments via Skyfire: > - MCP setup and configuration (including `?payment=skyfire` and optional `actors` preload). > - API usage with `skyfire-pay-id` header for Actor runs and data retrieval. > - Limitations and supported-actors filtering using `allowsAgenticUsers=true`. > > <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit 906522f. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup>

docs: add agentic payments docs

635be15

stepskop self-assigned this Oct 6, 2025

stepskop added the t-core-services Issues with this label are in the ownership of the core services team. label Oct 6, 2025

github-actions Bot added this to the 125th sprint - Core Services team milestone Oct 6, 2025

fix: lint

5ed44fe

fix: add page header

0e0e768

docs: extend openapi docs

a6a01c3

stepskop added 2 commits October 9, 2025 12:12

fix: indentation

79f472d

fix: missing response fields

9ecda75

stepskop requested a review from tobice October 13, 2025 16:47

chore: add experimental callout

8296458

fix: grammar

fbef6fd

chore: change the configuration example

906522f

stepskop marked this pull request as ready for review November 19, 2025 14:47

stepskop requested review from TC-MO, fnesveda and janbuchar as code owners November 19, 2025 14:47

stepskop requested a review from mhamas November 19, 2025 14:49

janbuchar removed their request for review November 19, 2025 21:01

tobice approved these changes Nov 20, 2025

View reviewed changes

fix: capitalization

9b87437

mhamas reviewed Nov 24, 2025

View reviewed changes

mhamas approved these changes Nov 24, 2025

View reviewed changes

chore: improve the referencing

3a2a5b4

TC-MO requested changes Nov 26, 2025

View reviewed changes

Merge branch 'master' into docs/agentic-payments

7a50673

chore: apply suggestions

9a0f0ad

stepskop requested a review from TC-MO November 27, 2025 17:12

chore: match the diagram

892b465

chore: correct numbering

f60459e

stepskop added 3 commits November 28, 2025 11:02

chore: add claude desktop configuration example

8ffeff0

fix: remove empty linek

6741d9e

chore: import tab items

f0f005e

TC-MO approved these changes Nov 28, 2025

View reviewed changes

fix: typos, writing style

7561f33

stepskop merged commit c36fc22 into master Dec 1, 2025
10 checks passed

stepskop deleted the docs/agentic-payments branch December 1, 2025 10:41

raethlo added the validated Issues that are resolved and their solutions fulfill the acceptance criteria. label Dec 1, 2025

marekh19 mentioned this pull request May 25, 2026

[FOR TESTING CI/CD] chore: emptiness is calming #1590

Closed


		Agentic payments enable AI agents to autonomously run Apify Actors using third-party payment providers, without requiring traditional Apify user accounts. This allows agents to discover, execute, and pay for web scraping and automation tasks independently.

		Currently, Apify supports agentic payments through Skyfire, a payment network specifically designed for AI agents.


		### Configuration

		Configure your MCP client to connect to both the Skyfire and Apify MCP servers. When connecting to the Apify MCP server for agentic payments, you must include the `?payment=skyfire` query parameter in the server URL. This enables the agentic payment flow and informs the agent about payment requirements.


		## Using Skyfire with Apify API

		For direct API integration, you can use Skyfire PAY tokens to authenticate and pay for Actor runs.


		Not all Actors in the Apify Store can be run using agentic payments.

		Apify maintains a curated list of Actors approved for agentic payments. To check if an Actor supports agentic payments, use the `allowsAgenticUsers=true` query parameter when [searching the store via API](https://docs.apify.com/api/v2#/reference/store/store-actors-collection/get-list-of-actors-in-store).

Conversation

stepskop commented Oct 6, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

apify-service-account commented Oct 6, 2025

Uh oh!

apify-service-account commented Oct 6, 2025

Uh oh!

apify-service-account commented Oct 6, 2025

Uh oh!

apify-service-account commented Oct 8, 2025

Uh oh!

apify-service-account commented Oct 9, 2025

Uh oh!

apify-service-account commented Oct 9, 2025

Uh oh!

apify-service-account commented Nov 3, 2025

Uh oh!

apify-service-account commented Nov 4, 2025

Uh oh!

apify-service-account commented Nov 19, 2025

Uh oh!

janbuchar commented Nov 19, 2025

Uh oh!

tobice left a comment

Choose a reason for hiding this comment

Uh oh!

tobice Nov 20, 2025

Choose a reason for hiding this comment

Uh oh!

stepskop Nov 21, 2025

Choose a reason for hiding this comment

Uh oh!

stepskop commented Nov 21, 2025

Uh oh!

apify-service-account commented Nov 21, 2025

Uh oh!

apify-service-account commented Nov 21, 2025

Uh oh!

mhamas left a comment

Choose a reason for hiding this comment

Uh oh!

mhamas Nov 24, 2025

Choose a reason for hiding this comment

Uh oh!

mhamas Nov 24, 2025

Choose a reason for hiding this comment

Uh oh!

mhamas Nov 24, 2025

Choose a reason for hiding this comment

Uh oh!

mhamas Nov 24, 2025

Choose a reason for hiding this comment

Uh oh!

mhamas Nov 24, 2025

Choose a reason for hiding this comment

Uh oh!

mhamas left a comment

Choose a reason for hiding this comment

Uh oh!

apify-service-account commented Nov 24, 2025

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

apify-service-account commented Nov 27, 2025

Uh oh!

apify-service-account commented Nov 27, 2025

Uh oh!

apify-service-account commented Nov 27, 2025

stepskop commented Oct 6, 2025 •

edited

Loading