Read
Inspect courses and runs
Discover owned courses, read generation state, inspect authoring snapshots, presenters, and configuration.
PersonWise · Model Context Protocol
One MCP for every PersonWise Skill.
A single remote, OAuth-protected course capability surface. General and future scenario Skills all use this same endpoint and versioned contract.
Canonical public contract
- Endpoint
- https://mcp.personwise.ai/mcp
- Transport
- Streamable HTTP
- Authorization
- OAuth 2.1 + PKCE
- Contract version
- 1.0.0
Architecture
Separate the job from the tools.
Skills carry task-specific judgment. The MCP remains one stable execution surface.
- 01
Skill
Recognizes the job, defines inputs and boundaries, and drives the quality workflow.
- 02
MCP
Provides authenticated course reads, durable mutations, resources, and capability discovery.
- 03
OAuth grant
Binds an Agent to one organization, an explicit course allowance, approved capabilities, and a publication ceiling.
Capability surface
Tools grouped by consequence.
The Agent discovers the live contract before mutation and requests only the capabilities required by the Skill.
Author
Create and refine
Create durable runs, advance stages, update slides and narration, upload approved materials, and manage visuals.
Publish
Finish within the ceiling
First-publish as draft, private, or link-accessible only when the user has explicitly granted that ceiling.
Control
Resume, retry, or cancel
Recover supported failures and continue existing work without duplicating durable tasks.
Authorization
The user stays in control.
Authorization begins inside the Agent and returns to that same client. PersonWise credentials and tokens never become Skill inputs.
- 01
Discover
The Agent reads the protected-resource and authorization-server metadata.
- 02
Approve
The user chooses the organization, capabilities, allowance, and publication ceiling on PersonWise.
- 03
Manage
The user can review, narrow, or revoke every Agent connection from account settings.
Trust boundary
Clear identity. Narrow authority. Revocable access.
- Official endpoint
- Only the HTTPS endpoint on mcp.personwise.ai is the public PersonWise MCP.
- No pasted secrets
- Do not paste API keys, authorization codes, access tokens, refresh tokens, or cookies into chat.
- Capability negotiation
- The Skill checks contract versions and required tools before consuming a credit or changing durable state.
- Publication ceiling
- An Agent cannot publish beyond the limit approved by the user, and Topics submission is separately authorized.
Ready to use
Start with the general course-creation Skill.
Install the public Skill, invoke it in your Agent, and approve the exact PersonWise access request when prompted.