Terminal
Terminal/Skill
Adds an MCP server from a URL you supply to a chosen Speakeasy AI Control Plane project, after inspecting and confirming the URL.
By Speakeasy
Works with
npx skills add speakeasy-api/marketplace --skill add-mcp-from-remote-urlUse this workflow only through the authenticated Speakeasy AI Control Plane (AICP) Platform MCP when the user supplies a remote MCP server URL that is not in the reviewed MCP Catalogue. It follows the same guarded outcome a user completes in the AICP dashboard: inspect the URL, confirm the bounded evidence and project, register privately, finish secure setup, and verify readiness. For a reviewed catalogue entry, use add-mcp-from-catalog instead. The package itself grants no organization access.
inspect_mcp_candidate as the only read-only inspection step for a user-supplied URL. It returns bounded evidence and does not register or distribute anything.send_platform_mcp_feedback only after asking for consent, and never include identifiers, URLs, credentials, payloads, headers, logs, or attachments.list_projects to verify that the Platform MCP is authenticated and obtain eligible projects. If discovery is unavailable, stop and ask the user to complete or repair AICP OAuth.search_mcp_catalog by name before handling the URL. Prefer an exact reviewed candidate when available.inspect_mcp_candidate with remote_url set to the user's exact URL. Do not supply catalogue selectors at the same time.register_remote_mcp with the exact project, URL, optional safe display name, and a fresh idempotency key. This re-inspects the URL and creates private project configuration only.get_mcp_readiness without force to report the persisted, actor-scoped evidence. Never force a provider probe from an assistant. A freshly registered MCP normally has no persisted evidence yet and reports readiness_unavailable; that is not a reason to stop. Provider attachment does not depend on readiness evidence: when inspection reported authentication_required, ask for explicit confirmation, call attach_platform_mcp_identity_provider, present its exact authorization URL, and wait for the user to use Connect or Authorize there. When inspection reported anonymous, the endpoint needs no upstream identity provider — skip attachment and continue.next_action is secure_dashboard_setup_required, present the exact dashboard_setup_url. The user completes authentication or secret entry outside chat; never request the resulting value.get_mcp_readiness with the selected project and returned registration ID. For a non-ready result, follow only its server-provided repair action. When it requires provider attachment, ask for explicit confirmation before attach_platform_mcp_identity_provider, then present its exact authorization URL.get_mcp_readiness with force: true. Do not rely on stale or inferred readiness.get_mcp_client_admission for the same project and registration ID and report the mode it returns together with the custom client ID metadata URLs it lists, which together decide which MCP clients may authorize against this server. Change it only when the user asks: explain what the proposed mode admits and refuses, ask for explicit confirmation, then call set_mcp_client_admission with that exact mode and confirmed: true. Known clients (presets) refuses an unlisted client at authorization with no fallback.OAuth consent, secret entry, and provider authorization are the expected out-of-agent stops. URL and project selection, registration confirmation, and provider-attachment confirmation stay in the conversation.