{"version":"muscap.agent-guide.v2","deployment_id":"remote-mcp-20261028-r2","environment":"staging","api_origin":"https://api-staging.muscap.me","billing_policy":{"mode":"account_balance","budget_scope":"account","maximum_songs":null,"maximum_credits":null,"ends_at":null,"automatic_recharge":false,"insufficient_action":"wait_for_credits"},"connect":[{"actor":"agent","call":"POST https://api-staging.muscap.me/api/v2/agent-connect/requests","send":{"required":["agent_name","agent_product_id","installation_id"],"scopes":{"account_creative":true,"music_creation":true},"optional":["expected_account_phone","delivery_secret"]},"keep":["id","poll_secret","connect_url"],"give_human":"connect_url"},{"actor":"human","do":"open connect_url, sign up or sign in, approve once"},{"actor":"agent","call":"POST https://api-staging.muscap.me/api/v2/agent-connect/poll","send":["session_id","poll_secret","delivery_secret"],"every_seconds":8,"until":"connected"},{"actor":"agent","call":"GET https://api-staging.muscap.me/api/v2/agent-connect/status","check":"account.phone_hint equals the named account before any write; stop on mismatch"},{"actor":"agent","call":"POST https://api-staging.muscap.me/api/v2/agent-connect/token","when":"401","send":{"refresh_token":"<saved>"},"schema":"#/components/schemas/RefreshRequest"}],"work":{"available_now":true,"required_scope":"creative:music:complete","card":"https://api-staging.muscap.me/api/v3/agent/work-card","submit":"POST https://api-staging.muscap.me/api/v3/agent/work-specs","update":"POST https://api-staging.muscap.me/api/v3/agent/work-specs/{id}","discuss":"POST https://api-staging.muscap.me/api/v3/agent/work-specs/{id}/discuss","wait":"GET https://api-staging.muscap.me/api/v3/agent/work-specs/{id}?wait=true","states":["needs_input","working","done","failed"],"idempotency":"Idempotency-Key per intent; reuse only to retry the same call","existing_drafts":"an older music draft_id is a valid work_spec_id","stop":"private_completed_work"},"work_images":{"available_now":true,"required_scope":"creative:work-images:write","entry_template":"https://api-staging.muscap.me/api/v3/agent/works/{work_id}/images","flow":["GET images","PUT upload_url","POST complete","POST save_url"],"completion":"work_images_saved or draft_images_saved","limits":{"mime_types":["image/jpeg","image/png","image/webp"],"maximum_bytes":10485760,"maximum_dimension_px":12000,"maximum_pixels":40000000,"maximum_photos":20,"maximum_covers":1,"maximum_allocated_bytes_per_work":440401920,"maximum_active_uploads_per_work":4,"active_upload_limit_scope":"agent_client_and_work","allocation_includes_upload_history":true,"animated_images":false,"remote_url_fetch":false,"photo_update_modes":["append_photo_asset_ids","photo_asset_ids"],"ordered_replacement_retains_assets_and_history":true,"billing_credits":0,"existing_song_preserved":true,"maximum_image_bytes":10485760,"animated":false}},"material_delivery":{"available_now":true,"endpoint":"https://api-staging.muscap.me/api/v3/agent/materials","receipt_endpoint_template":"https://api-staging.muscap.me/api/v3/agent/materials/{receipt_id}","required_scope":"creative:material:write","kinds":["text","lyrics","music_prompt","photo_note","voice_transcript"],"completion":"materials_saved; give user_url; saving is not a song"},"account_creative":{"available_now":true,"required_scope":"creative:account:write","entry":"https://api-staging.muscap.me/api/v3/agent/creative-objects","commands":["rename","supplement_text","new_music_from_work"],"new_music_continues_with":"work","delete_available":false},"mcp":{"transport":"stdio","distribution":"controlled_test_not_publicly_published","remote_endpoint":null,"installation_requires_user_consent":true,"connection_enabled":true},"integration_contract":{"revision":"muscap.agent-integration.v1","url":"https://api-staging.muscap.me/api/v3/agent/integration-contract","openapi":"https://api-staging.muscap.me/api/v3/agent/openapi.json","skill":"https://api-staging.muscap.me/api/v3/agent/skill.md","changelog_endpoint":"https://api-staging.muscap.me/api/v3/agent/changelog","conditional_read":{"header":"If-None-Match","unchanged_status":304},"fingerprint_algorithm":"sha256_utf8_json_ensure_ascii_false_sort_keys_compact_excluding_top_fingerprint"},"name":"MusCap","contract_version":"muscap.external-agent.v1","canonical_origin":"https://staging.muscap.me","authorization_origin":"https://staging.muscap.me","connection_available_now":true,"creation_available_now":true,"connection_status_endpoint":"https://api-staging.muscap.me/api/v2/agent-connect/status","connection_poll_interval_seconds":8,"browser_automation_required":false,"connection_storage":{"scope":"one_installation_one_original_client","temporary_directory_allowed":false,"refresh_single_flight_per_installation":true,"secrets_in_chat_or_reports":false},"connection_reuse":{"same_agent":"status_then_refresh_no_new_pairing","new_agent":"own_pairing_approved_by_owner","missing_scope":"open_status_user_action_url_once_keep_client","lost_refresh":"credential_recovery_invitation_same_installation_keeps_client_and_grant","revoked":"new_pairing","suspended":"wait_for_owner_resume"},"activities":{"entry":"https://api-staging.muscap.me/api/v3/agent/activities"},"recovery":[{"http_status":401,"next":"refresh_once_save_rotated_pair"},{"code":"agent.connection_revoked","next":"new_pairing"},{"code":"agent.connection_suspended","next":"wait_for_owner_resume"},{"http_status":402,"next":"state needs_input/credits; owner tops up; no automatic recharge or retry"},{"http_status":409,"next":"read detail.fix; retry with the fix"},{"http_status":412,"next":"GET current object, then resubmit"},{"http_status":429,"next":"respect Retry-After"},{"state":"failed","reason":"platform_review","next":"wait; do not resubmit"}],"human_only":["registration_codes","approval","publication","payment"],"account_policy":"one account may connect several Agents; credentials and grants are separate; credits are shared by the account","remote_mcp":{"endpoint":"https://api-staging.muscap.me/mcp","transport":"streamable_http","auth":"oauth2","installation_required":false},"openapi":"https://api-staging.muscap.me/api/v3/agent/openapi.json","human_documentation":"https://staging.muscap.me/agents"}