Developers
Give your agent a personality. Fetch any character as a ready-to-use prompt over REST, or connect the MCP server.
REST API
Read-only endpoints under https://agent-personas-production-4e2b.up.railway.app/api/v1. No key needed; CORS is open for GET. The full contract is the OpenAPI document.
List and filter
curl "https://agent-personas-production-4e2b.up.railway.app/api/v1/personas?vibe=sunny&limit=10"Get one character
curl https://agent-personas-production-4e2b.up.railway.app/api/v1/personas/pembertonGet the prompt
Formats: system, agents_md, skill, json. Intensity: pinch or full. Each response names exactly what it served: X-Scallywag-Revision and a SHA-256 in Repr-Digest. Keep them with your copy and check them against our advisories.
curl "https://agent-personas-production-4e2b.up.railway.app/api/v1/personas/pemberton/prompt?format=agents_md&intensity=full" -o AGENTS.mdSurprise me
curl "https://agent-personas-production-4e2b.up.railway.app/api/v1/personas/random?vibe=nerdy"Advisories
Any character we withdraw, with the SHA-256 of every file that was served, so tools can check saved prompts automatically.
curl https://agent-personas-production-4e2b.up.railway.app/api/v1/advisoriesWhat each character includes
List and detail responses (and MCP results) carry these fields; the full spec is under spec on the detail endpoint.
| Field | What it is |
|---|---|
| name, tagline | Who they are, in a line. |
| avatar | Illustrated portrait: { url, alt }. A square 512 px WebP (hand-drawn SVG stand-ins for now), absolute URL, with alt text. |
| says | One line, in their voice, to the user. Shown on cards; never part of the prompt. |
| voiceFont | serif, grotesque or mono: the font of their quotes. |
| vibe, goodFor, tags | What they're like and what they're good at. |
| flavour | Sweet, salty, spicy and chatty dials (0–10). |
| samples | Scripted exchanges (MCP say_hi serves these). |
| revision | First 12 hex chars of the spec's SHA-256. |
MCP server
Streamable HTTP at https://agent-personas-production-4e2b.up.railway.app/mcp. Tools: list_personas, get_persona, say_hi.
claude mcp add --transport http scallywag https://agent-personas-production-4e2b.up.railway.app/mcpLimits and errors
Anonymous calls are limited to 60 requests per minute per IP; over the limit you get 429 with a Retry-After header. Errors always look like:
{ "error": { "code": "not_found", "message": "No persona with slug 'nobody'" } }Codes: not_found, invalid_param, rate_limited.