hermes tools (scope: mcp:read, credits: ~0)
Save a draft post to the SN content library.
Save a draft post to the SN content library. Use when an autonomous agent (Hermes) wants to persist a draft before the founder approves it. Lands in ContentLibrary with status=draft, origin=hermes. The draft can then be approved/edited in the SN UI.
Save a draft post to the SN content library. › Request Body
copyThe draft post body.
project_idSN project UUID. Optional but recommended.
media_urlOptional cover/media URL (R2 signed URL).
hermes_run_idHermes cron run id, for traceability.
source_intel_idsOptional list of intel_signals.id rows that informed this draft.
response_formatSave a draft post to the SN content library. › Responses
Successful tool execution.
Persist a learned voice lesson to brand_profiles.
Persist a learned voice lesson to brand_profiles.platform_voice.voice_lessons. Use after weekly reflection identifies a hook/format/CTA pattern that beats median engagement by ≥30%. Appears in SN Brand > BrandBrainPreview > Voice lessons (auto).
Persist a learned voice lesson to brand_profiles. › Request Body
project_idSN project UUID.
lessonOne-sentence rule (e.g. "lowercase IG hooks beat title-case").
applies_toPlatforms this lesson applies to.
evidenceEngagement lift vs baseline, in percentage points.
response_formatPersist a learned voice lesson to brand_profiles. › Responses
Successful tool execution.
Record an agent observation (Hermes noticed X this week).
Record an agent observation (Hermes noticed X this week). Surfaces in UnifiedAnalytics > Playbook tab. Use for weekly reflection digests and mid-campaign pulse summaries.
Record an agent observation (Hermes noticed X this week). › Request Body
summaryOne-paragraph summary, founder-facing.
deltasOptional structured key/value payload (e.g. {topic_x_er_pct: 23}).
run_idHermes cron run id for traceability.
response_formatRecord an agent observation (Hermes noticed X this week). › Responses
Successful tool execution.
Record a research/trend signal (news, HN post, competitor change, arxiv paper).
Record a research/trend signal (news, HN post, competitor change, arxiv paper). Surfaces in SN Brand > Niche Intelligence. Dedupes by URL per user — safe to call multiple times for the same source.
Record a research/trend signal (news, HN post, competitor change, arxiv paper). › Request Body
sourceWatcher name (e.g. "news-watch", "hackernews-watch").
urlCanonical URL of the source. Used for dedupe.
topicBest-fit topic key.
titlesummaryOne-paragraph summary of the signal.
scoreRelevance score from the watcher (0–10 typical).
response_formatRecord a research/trend signal (news, HN post, competitor change, arxiv paper). › Responses
Successful tool execution.
Log a campaign cost line.
Log a campaign cost line. Use when Hermes incurs spend that should be attributed to a campaign — drafts, renders, paid amp. Categories: hermes_drafts / carousel_renders / analytics_pulls / paid_amplification / other. Read aggregate via get_active_campaigns.
Log a campaign cost line. › Request Body
campaign_idCampaign identifier (slug).
categoryCost category.
amount_usdAmount in USD; supports 4 decimal places.
response_formatLog a campaign cost line. › Responses
Successful tool execution.
List currently-running campaigns with thesis, budget, hero format, and current spend.
List currently-running campaigns with thesis, budget, hero format, and current spend. Used by Hermes pitch skill to bias drafts toward active campaign themes.
List currently-running campaigns with thesis, budget, hero format, and current spend. › Request Body
response_formatList currently-running campaigns with thesis, budget, hero format, and current spend. › Responses
Successful tool execution.