Scallywag

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/pemberton

Get 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.md

Surprise 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/advisories

What each character includes

List and detail responses (and MCP results) carry these fields; the full spec is under spec on the detail endpoint.

FieldWhat it is
name, taglineWho they are, in a line.
avatarIllustrated portrait: { url, alt }. A square 512 px WebP (hand-drawn SVG stand-ins for now), absolute URL, with alt text.
saysOne line, in their voice, to the user. Shown on cards; never part of the prompt.
voiceFontserif, grotesque or mono: the font of their quotes.
vibe, goodFor, tagsWhat they're like and what they're good at.
flavourSweet, salty, spicy and chatty dials (0–10).
samplesScripted exchanges (MCP say_hi serves these).
revisionFirst 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/mcp

Limits 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.