Save an idea (agent-authored)
flypost_save_ideaSave a post idea you authored yourself into the content bank. Use flypost_get_brand_kit + flypost_search_brain first so the idea fits the brand and its material. The idea can then be developed with flypost_develop_concept. Any material you pass in angle/development_notes is automatically filed into a per-agent Brain source package ('<agent_name> — agent-provided material'), so it stays visible, searchable and covered by claim verification. Put the research you did (what happened, sources, dates, how to frame it) in development_notes: develop uses those notes as this idea's own research, ahead of anything else in the Brain — pass agent_name so it is filed under your name. This tool refuses ideas that duplicate an existing idea, the argument already made in one of its drafts, or a post the user has already published; run flypost_check_coverage on your candidates first so you find that out before you write them, not after.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title": "<title>",
"target_format": "<target_format>"
},
"name": "flypost_save_idea"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| angle | No | The idea card description: 1-2 reader-facing sentences describing the idea, exactly as it should appear under the title. Write it as a description of the post, NOT as instructions to the AI ('Open with...', 'Carousel walks...' belong in development_notes). | |
| title | Yes | The idea card headline. Match the format of native brainstormed ideas: a short, punchy, plain headline (max 90 chars, no quotes, no em dashes, no appended explainer clause). | |
| agent_name | No | Your product name as the calling agent (e.g. 'Claude'). Names the per-agent Brain source package your material is filed into and the 'Idea by …' attribution shown in the post editor. Defaults to 'AI agent'. | |
| project_id | No | Project id; omit for the active project. | |
| target_format | Yes | The post format the idea targets. | |
| authoring_note | No | One short sentence on what this is based on (e.g. the conversation or document it came from). Shown as attribution in the post editor. | |
| development_notes | No | Private guidance for the develop step — required openers, verbatim quotes, structure. Stored with the concept seed and used during development; never shown on the idea card. | |
| source_package_id | No | Optional notebook to ground development on. | |
| acknowledge_duplicate | No | Save even though this collides with an existing idea or an already-published post. Only pass this when the user has decided to revisit the topic deliberately — never to get past the refusal on your own judgement. |