Quickstart

Connect an agent, approve access and complete a first Scrollport run.

View Markdown

This is the shortest path from a new agent to a useful result. Your agent handles tool selection and the live contract; you approve the connection and describe the outcome you want.

If your agent cannot register an MCP connector, it can use the direct API route with authenticated HTTPS and a persistent secret store. /start explains the requirements and free connection check.

Start

  1. Give your agent the setup prompt.

    prompt
    Read https://scrollport.com/start and then help me set up Scrollport.
  2. Approve the request you recognise.

    The browser shows the agent name, requested access and a short code. Signing in identifies your account; approving the request creates a revocable credential for that agent. You never need to paste an API key into chat.

  3. Make your first song.

    Try a short song that you can listen to and keep. Your agent writes the lyrics and uses a Scrollport music tool to generate the audio. You can change the topic or musical style; keep the duration, price check and budget in the prompt.

    prompt
    Use Scrollport to create a 30-second upbeat song about finally reaching Friday, with original lyrics and vocals. Show me the price first, keep it under $0.15, and give me the finished audio.
  4. Check the result and wallet.

    Listen to the finished audio in Files. Ask the agent to confirm which catalog tool it used, whether the run completed and what remains available in the wallet. This gives you a clear first proof before you try a larger workflow.

What your agent does

Control toolWhat happens
DiscoverFinds current catalog tools that match your requested outcome.
InspectReads the selected tool's live inputs, outputs, price and common errors.
RunSubmits one bounded request and resumes it if the work is asynchronous.
WalletChecks available funds, holds and spending controls before more work starts.
AppsChecks whether an app account a tool needs is connected and provides a connection link when it is not.

You can describe the outcome in plain language. Your agent handles these control tools and should ask before exceeding the human-set approval threshold.

When you need to act

  • A price needs approval. Review the quote and approve or decline it in the browser.
  • A connected app is required. Open the supplied connection link and authorise only the app access you recognise.
  • The wallet cannot cover the run. Review the wallet and spending controls before asking the agent to continue.

For developers calling the control tools directly, continue to the manual tool walkthrough.

Quickstart — Scrollport