signup

Create a new Mattalk account. Returns a JWT token that expires in 26 days. Username must be at least 3 characters, password at least 7 characters with 1 digit.

Parameters2

username	string	required	Username (min 3 chars, must be unique)
password	string	required	Password (min 7 chars, must contain at least 1 digit)

Raw schema

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": "Username (min 3 chars, must be unique)"
    },
    "password": {
      "type": "string",
      "description": "Password (min 7 chars, must contain at least 1 digit)"
    }
  },
  "required": [
    "username",
    "password"
  ]
}

login

Login to an existing Mattalk account. Returns a JWT token that expires in 26 days. Use this token as Bearer auth for subsequent MCP calls.

Parameters2

username	string	required	Your username
password	string	required	Your password

Raw schema

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": "Your username"
    },
    "password": {
      "type": "string",
      "description": "Your password"
    }
  },
  "required": [
    "username",
    "password"
  ]
}

create_story

Generate a new story from your idea. Creates an illustrated storybook (MD), an AI song, or an AI drama video. Returns a storyId immediately — processing happens in the background. Use get_story to check progress.

Parameters12

title	string	optional	Story title (optional, defaults to "Untitled")
storyIdea	string	required	Your story idea, prompt, or description
type	string	required	script=illustrated storybook, song=AI music with cover art, drama=AI video
outputs	array	required	What to create: md (storybook), song, or drama (video)
duration	string	optional	snappy=shorter/faster, exq=longer/higher quality, clappy=premium video (90-180s, new stories only). Default: snappy
scriptStyle	string	optional	Writing style for storybook: William Shakespeare, Jane Austen, Charles Dickens, etc.
playStyle	string	optional	Writing style for play/screenplay: Oscar Wilde, Stan Lee, etc.
songStyle	string	optional	Music artist style: Amy Winehouse, David Bowie, etc.
dramaStyle	string	optional	Director style for video: Quentin Tarantino, Christopher Nolan, etc.
dramaTheme	string	optional	Video theme: standard (animation), scifi, mythical. Default: standard
songDuration	string	optional	snappy=~60sec, exq=1.5-3min (default: snappy)
contextVersionIds	array	optional	Optional: link previous episodes for context. Use get_story to find version IDs.

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Story title (optional, defaults to \"Untitled\")"
    },
    "storyIdea": {
      "type": "string",
      "description": "Your story idea, prompt, or description"
    },
    "type": {
      "type": "string",
      "enum": [
        "script",
        "song",
        "drama"
      ],
      "description": "script=illustrated storybook, song=AI music with cover art, drama=AI video"
    },
    "outputs": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "md",
          "song",
          "drama"
        ]
      },
      "description": "What to create: md (storybook), song, or drama (video)"
    },
    "duration": {
      "type": "string",
      "enum": [
        "snappy",
        "exq",
        "clappy"
      ],
      "description": "snappy=shorter/faster, exq=longer/higher quality, clappy=premium video (90-180s, new stories only). Default: snappy"
    },
    "scriptStyle": {
      "type": "string",
      "description": "Writing style for storybook: William Shakespeare, Jane Austen, Charles Dickens, etc."
    },
    "playStyle": {
      "type": "string",
      "description": "Writing style for play/screenplay: Oscar Wilde, Stan Lee, etc."
    },
    "songStyle": {
      "type": "string",
      "description": "Music artist style: Amy Winehouse, David Bowie, etc."
    },
    "dramaStyle": {
      "type": "string",
      "description": "Director style for video: Quentin Tarantino, Christopher Nolan, etc."
    },
    "dramaTheme": {
      "type": "string",
      "enum": [
        "standard",
        "scifi",
        "mythical"
      ],
      "description": "Video theme: standard (animation), scifi, mythical. Default: standard"
    },
    "songDuration": {
      "type": "string",
      "enum": [
        "snappy",
        "exq"
      ],
      "description": "snappy=~60sec, exq=1.5-3min (default: snappy)"
    },
    "contextVersionIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional: link previous episodes for context. Use get_story to find version IDs."
    }
  },
  "required": [
    "storyIdea",
    "type",
    "outputs"
  ]
}

remix_story

Turn an existing story into a different format. For example, convert a storybook into a song or video. Uses the same story text — faster and cheaper than creating from scratch. Not available for Model A accounts.

Parameters5

storyId	string	required	The story to remix. Use list_stories to find your story first.
targetFormat	string	required	What to create: md (storybook), song (AI music), or drama (AI video)
duration	string	optional	Override duration (optional)
songDuration	string	optional	Override song duration (optional)
dramaTheme	string	optional	Video theme override (optional)

Raw schema

{
  "type": "object",
  "properties": {
    "storyId": {
      "type": "string",
      "description": "The story to remix. Use list_stories to find your story first."
    },
    "targetFormat": {
      "type": "string",
      "enum": [
        "md",
        "song",
        "drama"
      ],
      "description": "What to create: md (storybook), song (AI music), or drama (AI video)"
    },
    "duration": {
      "type": "string",
      "enum": [
        "snappy",
        "exq"
      ],
      "description": "Override duration (optional)"
    },
    "songDuration": {
      "type": "string",
      "enum": [
        "snappy",
        "exq"
      ],
      "description": "Override song duration (optional)"
    },
    "dramaTheme": {
      "type": "string",
      "enum": [
        "standard",
        "scifi",
        "mythical"
      ],
      "description": "Video theme override (optional)"
    }
  },
  "required": [
    "storyId",
    "targetFormat"
  ]
}

quake_story

Regenerate a story completely fresh. Same original idea, but creates a brand new version from scratch with new text and media. Like a "do-over". Not available for Model B accounts.

Parameters9

storyId	string	required	The story to regenerate. Use list_stories to find your story first.
output	string	required	What to create: md (storybook), song (AI music), or drama (AI video)
duration	string	optional	Override duration (optional)
songDuration	string	optional	Override song duration (optional)
scriptStyle	string	optional	Override writing style (optional)
playStyle	string	optional	Override play writing style (optional)
songStyle	string	optional	Override music artist style (optional)
dramaStyle	string	optional	Override director style (optional)
dramaTheme	string	optional	Video theme override (optional)

Raw schema

{
  "type": "object",
  "properties": {
    "storyId": {
      "type": "string",
      "description": "The story to regenerate. Use list_stories to find your story first."
    },
    "output": {
      "type": "string",
      "enum": [
        "md",
        "song",
        "drama"
      ],
      "description": "What to create: md (storybook), song (AI music), or drama (AI video)"
    },
    "duration": {
      "type": "string",
      "enum": [
        "snappy",
        "exq"
      ],
      "description": "Override duration (optional)"
    },
    "songDuration": {
      "type": "string",
      "enum": [
        "snappy",
        "exq"
      ],
      "description": "Override song duration (optional)"
    },
    "scriptStyle": {
      "type": "string",
      "description": "Override writing style (optional)"
    },
    "playStyle": {
      "type": "string",
      "description": "Override play writing style (optional)"
    },
    "songStyle": {
      "type": "string",
      "description": "Override music artist style (optional)"
    },
    "dramaStyle": {
      "type": "string",
      "description": "Override director style (optional)"
    },
    "dramaTheme": {
      "type": "string",
      "enum": [
        "standard",
        "scifi",
        "mythical"
      ],
      "description": "Video theme override (optional)"
    }
  },
  "required": [
    "storyId",
    "output"
  ]
}

get_story

Get story details, versions, and media download links. Story status can be: pending, processing, paraphrasing, generating, generating_media, completed, failed.

Parameters1

storyId

string

required

The story ID. Use list_stories to find it.

Raw schema

{
  "type": "object",
  "properties": {
    "storyId": {
      "type": "string",
      "description": "The story ID. Use list_stories to find it."
    }
  },
  "required": [
    "storyId"
  ]
}

list_stories

List all your stories with their titles, status, and type.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_balance

Check your account balance. For B2C: shows credit count. For Model A: shows quota remaining and prepaid balance. For Model B: shows prepaid balance in USD.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

delete_story

Delete a story and all its media (files, versions, logs). This cannot be undone. Use list_stories to find story IDs.

Parameters1

storyId

string

required

The story ID to delete

Raw schema

{
  "type": "object",
  "properties": {
    "storyId": {
      "type": "string",
      "description": "The story ID to delete"
    }
  },
  "required": [
    "storyId"
  ]
}

buy_credits

Get a Stripe payment link to add funds. For B2C: buy credit packs (Starter/Writer/Author/Storyteller). For B2B: top up prepaid balance with preset amounts.

Parameters1

pack

string

optional

B2C only: starter=40cr/$10.99, writer=120cr/$20.99, author=350cr/$38.99, storyteller=600cr/$40.99

Raw schema

{
  "type": "object",
  "properties": {
    "pack": {
      "type": "string",
      "enum": [
        "starter",
        "writer",
        "author",
        "storyteller"
      ],
      "default": "starter",
      "description": "B2C only: starter=40cr/$10.99, writer=120cr/$20.99, author=350cr/$38.99, storyteller=600cr/$40.99"
    }
  }
}

Mattalk

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

signup

login

create_story

remix_story

quake_story

get_story

list_stories

get_balance

delete_story

buy_credits

Install

Remote endpoint