Skip to content

docs: make keyless verb lists surface-aware - #1127

Open
Max17190 wants to merge 5 commits into
mainfrom
docs/ai-onboarding-keyless-invite
Open

docs: make keyless verb lists surface-aware#1127
Max17190 wants to merge 5 commits into
mainfrom
docs/ai-onboarding-keyless-invite

Conversation

@Max17190

@Max17190 Max17190 commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Why

A single keyless verb list misleads agents across surfaces: CLI/SDK/REST keyless includes interact, but hosted MCP keyless does not. ai-onboarding still used fallback framing, and rate-limits Keyless still lumped MCP with CLI/SDK as if interact were keyless everywhere.

Summary

  • Replace the Get credentials keyless paragraph in ai-onboarding.mdx
  • Drop “meant as a fallback” / human-unavailable framing
  • Make keyless verb lists surface-aware in ai-onboarding.mdx and rate-limits.mdx:
    • CLI / SDKs / REST: search, scrape, interact, and parse
    • Hosted MCP: search, scrape, and parse (interact needs an API key)
  • Keep the signup nudge for higher rate limits, other endpoints, or production

Aligns with:

Test Plan

  • Diff is only base ai-onboarding.mdx and rate-limits.mdx (no localized files)
  • ai-onboarding Get credentials distinguishes CLI/SDK/REST from hosted MCP
  • rate-limits Keyless distinguishes CLI/SDK/REST from hosted MCP
  • Both pages include parse on the correct surfaces and note interact needs a key on hosted MCP
  • Links to /rate-limits#keyless-no-api-key and /mcp-server resolve
  • Preview Get credentials and Keyless sections on the docs site

Max17190 added 3 commits July 8, 2026 16:34
Align Get credentials copy with MCP and agent-onboarding: drop fallback framing, add parse, and point agents at hosted MCP plus signup for higher limits.
Capitalize the sentence start, drop the em dash, and point only at Keyless rate limits instead of hosted MCP.
Match the search-first ordering used elsewhere in agent onboarding.

@hmishra2250 hmishra2250 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Make this surface-aware: it's accurate for one path, misleading for the other. CLI/SDK/REST keyless = scrape, search, interact, parse; hosted MCP keyless = scrape, search, parse (interact needs a key on MCP). Current line drops parse and over-includes interact.

CLI/SDK/REST keyless includes interact; hosted MCP keyless is search, scrape, and parse only.
Hosted MCP keyless is scrape/search/parse; interact remains key-gated there while CLI, SDKs, and REST keep interact.
@Max17190 Max17190 changed the title docs(ai-onboarding): invite keyless scrape/search/interact/parse docs: make keyless verb lists surface-aware Jul 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants