Skip to content

docs(mcp): Add Skyfire agentic payments and hosted server benefits docs#2236

Open
MQ37 wants to merge 10 commits intomasterfrom
claude/review-prs-update-docs-mDG3c
Open

docs(mcp): Add Skyfire agentic payments and hosted server benefits docs#2236
MQ37 wants to merge 10 commits intomasterfrom
claude/review-prs-update-docs-mDG3c

Conversation

@MQ37
Copy link
Contributor

@MQ37 MQ37 commented Feb 10, 2026

Summary

This PR adds documentation for two new features in the Apify MCP server:

  1. Highlights the benefits of using the hosted MCP server over local stdio setup
  2. Introduces the new Skyfire integration for agentic payments

Key Changes

  • Hosted server tip: Added a prominent tip section explaining that the hosted Apify MCP server at https://mcp.apify.com supports output schema inference for structured Actor results, which is not available in local stdio mode
  • Skyfire agentic payments section: Added comprehensive documentation covering:
    • Overview of how Skyfire enables autonomous payments for Actor runs without requiring Apify API tokens
    • Prerequisites (Skyfire account with funded wallet, compatible MCP client)
    • Setup instructions with example configuration showing both Skyfire and Apify servers
    • Step-by-step explanation of the payment flow (discovery → PAY token creation → Actor execution → results)
    • Links to related documentation and blog post

Implementation Details

  • The tip about hosted server benefits is placed early in the transport section to guide users toward the recommended setup
  • Skyfire integration documentation is positioned as a new top-level section before the Telemetry section
  • Configuration examples use standard JSON format for easy copy-paste into MCP client configs
  • Documentation includes clear prerequisites and step-by-step workflow explanation to help users understand the autonomous payment flow

https://claude.ai/code/session_01URvA6cQdYqwCF1s1PWNL6v


Note

Low Risk
Documentation-only changes; no runtime behavior, security, or billing logic is modified.

Overview
Adds a new hosted server tip to the MCP quick-start docs explaining that https://mcp.apify.com provides output schema inference (field-level typed output schemas) that is not available in local stdio mode.

Introduces a new "Agentic payments with Skyfire" section describing tokenless Actor execution via Skyfire PAY tokens, including prerequisites, multi-server client configuration (using ?payment=skyfire), and the end-to-end payment flow (discover Actor → create PAY token → pass skyfire-pay-id → run).

Written by Cursor Bugbot for commit 55c85ba. Configure here.

… docs

- Add tip about hosted server output schema inference feature (from PR #311)
- Add new "Agentic payments with Skyfire" section with setup guide and
  configuration example (from PR #450)

https://claude.ai/code/session_01URvA6cQdYqwCF1s1PWNL6v
- Use _italics_ for new terms (agentic payments, PAY tokens, output
  schema inference) per Microsoft style guide
- Format prerequisites with _Term_ - Description pattern to match
  existing doc conventions
- Add link to Skyfire dashboard for API key instructions

https://claude.ai/code/session_01URvA6cQdYqwCF1s1PWNL6v
@MQ37 MQ37 requested a review from TC-MO as a code owner February 10, 2026 16:25
@github-actions github-actions bot added the t-ai Issues owned by the AI team. label Feb 10, 2026
@MQ37 MQ37 changed the title Add Skyfire agentic payments and hosted server benefits docs docs(mcp): Add Skyfire agentic payments and hosted server benefits docs Feb 10, 2026
@apify-service-account
Copy link

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

@apify-service-account
Copy link

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

Include input schema, README, pricing, and Actor output schema in the
tool description.

https://claude.ai/code/session_01URvA6cQdYqwCF1s1PWNL6v
@MQ37
Copy link
Contributor Author

MQ37 commented Feb 10, 2026

FYI @jirispilka

@apify-service-account
Copy link

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

Copy link
Contributor

@TC-MO TC-MO left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Few changes requested

change sequential numbering in numbered list
rewrote tip & its title for clarity
improved passive voice to active voice
fixed pre-existing typo


:::tip Use the hosted server for the best experience

The hosted Apify MCP server at `https://mcp.apify.com` supports the latest features, including _output schema inference_ for structured Actor results. When using the hosted server, Actor tools automatically include inferred output schemas with field-level type information, helping AI agents understand the expected result structure before calling an Actor. This feature is not available when running locally via stdio.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Any reason why not make this also a link?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

because other mentions of the mcp.apify.com are also not link so I wanted to keep it consistent - we can make it a link, I dont have any preference

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think in this case link makes sense so I would turn this into one

MQ37 and others added 3 commits February 13, 2026 09:54
Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>
Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>
Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>
@apify-service-account
Copy link

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

1 similar comment
@apify-service-account
Copy link

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

@apify-service-account
Copy link

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

Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>
@MQ37
Copy link
Contributor Author

MQ37 commented Feb 13, 2026

Thank you for the review! 👍 @TC-MO

@apify-service-account
Copy link

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

Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>
@apify-service-account
Copy link

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

t-ai Issues owned by the AI team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants