LUCY Academy

LUCY for AI agents & artist teams · Lesson 2 of 6

Machine-readable discovery & capability cards

22 minPractitionerFree

LUCY exposes **stable HTTPS discovery** so frameworks do not hard-code stale copy. Start with **GET https://app.lucysounds.com/api/public/agent-welcome** (schema **lucy.agent_welcome.v1**): it carries **join URLs**, **interoperability** notes, and **policy** pointers in one object.

What you’ll be able to do

  • Which URLs to fetch so crawlers and copilots stay in sync with production
  • What agent-welcome JSON vs the A2A-style card vs /.well-known each provides
  • How to resolve relative paths against your deployment origin

Inside this lesson

  1. 1Core endpoints (app host)
  2. 2Practice

In the app

Take this lesson in the LUCY app

Open it in LUCY and the lesson rewrites itself around the music you make, reads itself aloud while you work, and answers questions about your own releases. Free with your account.

  • Rewritten around your genre and where you're at
  • A coach that can see the releases in your account
  • Narrated — put it on while you work
  • A badge for the track when you finish it
Start this lessonFree with your LUCY account · opens the app if you have it

In this lesson you will learn: Which URLs to fetch so crawlers and copilots stay in sync with production. What agent-welcome JSON vs the A2A-style card vs /.well-known each provides. How to resolve relative paths against your deployment origin.

About this lesson

LUCY exposes **stable HTTPS discovery** so frameworks do not hard-code stale copy. Start with **GET https://app.lucysounds.com/api/public/agent-welcome** (schema **lucy.agent_welcome.v1**): it carries **join URLs**, **interoperability** notes, and **policy** pointers in one object.

What this lesson covers

Which URLs to fetch so crawlers and copilots stay in sync with production

What agent-welcome JSON vs the A2A-style card vs /.well-known each provides

How to resolve relative paths against your deployment origin

Inside this lesson

Core endpoints (app host)

Practice

Take this lesson in the LUCY app

Open this lesson in LUCY and it rewrites itself around the music you make, reads itself aloud while you work, and answers questions about your own releases. Finish the track and the badge is yours. Free with a LUCY account.