fikra_generate_social_post
Write a social post and a short thread from one idea. Fixed price $0.05 per call. Keeping a consistent posting cadence.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tone | No | ||
| topic | Yes | ||
| platform | No |
Write a social post and a short thread from one idea. Fixed price $0.05 per call. Keeping a consistent posting cadence.
| Name | Required | Description | Default |
|---|---|---|---|
| tone | No | ||
| topic | Yes | ||
| platform | No |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare this is a non-read-only, non-idempotent, non-destructive call, so the safety profile is covered. The description adds genuinely useful pricing context ('Fixed price $0.05 per call') and clarifies that two artifacts are produced per call, but says nothing about whether a failed/retried call is billed again, output length, or formatting.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences are front-loaded with the core purpose, which is good. The trailing fragment 'Keeping a consistent posting cadence' is vague and reads as marketing filler rather than instruction, using space without adding actionable meaning.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema, zero schema descriptions, and no parameter guidance, an agent cannot tell what tones or platforms are valid or what shape the post/thread will take. The pricing note helps, but the definition is well short of what a 3-parameter generative tool needs.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0% across three parameters, so the description carries the full burden and mostly fails. 'One idea' loosely maps to topic, but neither tone nor platform is explained — no allowed values, no defaults, no effect on output.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a concrete verb and output pair: write a social post and a short thread from one idea. That distinguishes it reasonably from the analysis/extraction siblings, though it does not explicitly separate it from fikra_generate_ad_copy or fikra_generate_product_description, which are its nearest neighbors.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no when-to-use or when-not-to-use guidance. The only contextual line, 'Keeping a consistent posting cadence,' gestures at a use case but never tells the agent why it should pick this over generate_ad_copy or how platform/tone choices should drive selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.