Developer guide
Bring your agent into Personify.
Give your AI assistant brand context and draft tools. Review and approve generation in Personify.
Connect
- In a client that supports remote MCP, Streamable HTTP and OAuth with dynamic client registration, add
https://personify.gg/api/mcp. - Follow the sign-in link. Choose one brand and review the requested permissions.
- Ask your agent to read the brand. Then open Settings → AI connections to confirm the connection is verified.
No secret key or Personify password belongs in your client configuration. Revoke a connection in Settings whenever you need to.
Try a useful request
Read my connected brand and approved assets. Write a 25-word product introduction, save one unscheduled draft, and return the review link.
Example responses · no account access or live tool calls
get_brand
{ "company_name": "Sample brand", "brand_tone": "Conversational" }The owner opens the review link and approves the generation quote in Personify.
Available tools
| Tool | Purpose | Scope |
|---|---|---|
| get_brand | Read the authorized brand | brand:read |
| list_approved_assets | Find reviewed reusable media | assets:read |
| list_assets | List finished reels, their takes and clips, and brand photos | assets:read |
| list_formats | List the Format Book reel formats a draft can follow | videos:read |
| list_videos | List the latest 50 drafts and statuses | videos:read |
| get_video | Read a draft or render status by ID | videos:read |
| get_video_download | Get a one-hour download link for a finished, approved video | videos:read |
| create_draft | Save an unscheduled draft with a stable request_id, optionally in a format | drafts:write |
| edit_draft | Edit an unrendered draft using its latest updated_at | drafts:write |
| prepare_generation_approval | Return the owner’s review link | videos:read |
| quote_video | Price one render in credits (optional permission) | videos:render |
| render_video | Start a quoted render with confirm: true (optional permission) | videos:render |
Drafts stay under your control
Connections are scoped to one owned brand. Create requests reuse a UUID request_id; edits require the latest updated_at. If a draft changed, read it again before retrying. The tools cannot publish posts or change billing, and they cannot buy generation unless you grant the optional videos:render permission, which the Personify CLI asks for only with personify login --allow-render. Even then every take is quoted first and started with an explicit confirmation. Saved assets and scripts are data, not instructions for the agent.
Connection troubleshooting
Authorized means consent is saved; verified means a tool call succeeded. If you see “needs reconnect,” authorize again in your client. Check remote HTTP, OAuth, PKCE S256 and dynamic client registration support. Discovery is available at the protected-resource metadata endpoint.