Sign-in and billing
The MCP server signs in with your MOSS account and charges that account's credits, at the same price as the API. You don’t create or paste an API key.
Sign in
Add the server
Add the MCP URL in your client; see Connect a client.
Sign in in the browser
The first time a tool needs your account, your client opens the MOSS sign-in page in the browser.
Allow access
The consent page shows the client asking for access, the domain it returns to, your account, and your credit balance. If it all looks right, click “Allow”.
Return to the client
When the page says “Connected”, go back to your client and continue; the agent can now use the tools.
Billing rules
| Rule | Details |
|---|---|
| Account | Uses the same account and the same credit balance as calling the API directly. |
| Price | Same as calling the API directly; see Pricing. |
| Paid tools | generate_image, generate_speech, generate_dialogue, design_voice, and their _async versions are charged by usage; see Capabilities and tools. |
| Free tools | list_voices, get_task, get_usage, and create_mcp_key are free. |
| Retries are not charged twice | Retrying a paid tool after a timeout or a dropped connection does not generate again or charge twice. |
| Voice design | Asking to save after the audition generates again, is charged again, and may sound different. To keep a voice, save it when you generate it. |
Usage
Ask the agent “How many credits do I have left?” or “How much did I use this month?” and it checks with get_usage: available and frozen credits, usage today and this month, and how many days your credits last at the last 7 days’ rate.
Good to know
| Topic | Details |
|---|---|
| Result links | Generated images and audio come back as links; download them if you want to keep them. |
| Async tasks | _async tools return a task ID right away; check it with get_task until it succeeds, fails, or is canceled. |
| Voice IDs | Speech and dialogue need voice IDs: find one with list_voices, or design and save a new one with design_voice. |
| Visible watermark | Generated images carry a visible watermark by default; you can replace it with your own image or turn it off. AIGC metadata is always kept. |