Five-minute install
1. Generate a PAT at /settings/api-keys. Tokens prefix with niche_sk_.
2. Add the server to your agent client. Claude Code (CLI):
claude mcp add --transport http niche https://api.nicheangle.com/mcp \
--header "Authorization: Bearer niche_sk_..."Claude Code (project .mcp.json) — note the field is type, value http:
{
"mcpServers": {
"niche": {
"type": "http",
"url": "https://api.nicheangle.com/mcp",
"headers": {
"Authorization": "Bearer niche_sk_..."
}
}
}
}Claude Desktop: Settings → Connectors → Add custom connector → paste the URL, choose Streamable HTTP, add your PAT. Cursor (~/.cursor/mcp.json): just url + headers (no transport field).
3. Restart the client (or open a new thread) — MCP clients cache the connection (auth + the tools/list) at connect time, so reconnect after changing your token or to pick up new tools. Your agent then sees all 25 Niche tools.
The 25-tool surface
Tools group into 7 functional bands. Full schemas live at /.well-known/agent-skills/index.json (auto-generated from the live registry, always in sync with the server's tools/list response).
Discovery + state
7 TOOLSStart an editorial run for a niche, or ask an analyst-shaped intelligence query (ranked slate + engine-grounded, fact-verified narratives). Poll or long-poll session state with `since_status`, list past sessions, revert to any prior checkpoint, cancel mid-flight, export a finished run.
niche_signal_scanniche_intelligence_queryniche_session_stateniche_list_sessionsniche_session_revertniche_session_cancelniche_session_export
Editorial
1 TOOLPropose 3 frame-aware angles per picked story with frame, hook, tension, CTA, a verifier audit, and a recommended_angle_id scored against the brand profile. Pass custom_framing to author your own angle.
niche_angle_propose
Drafting
5 TOOLSGenerate platform-native drafts with trust fields (faithfulness score + claim count, ungrounded claims, source diversity, recency). Sub-field revision with a diff[] return — you supply the new text. Add new output cells after review, or reuse an existing rendered image across cells. Or skip research and draft straight from a take or URL (niche_draft_direct).
niche_draft_directniche_draft_createniche_draft_reviseniche_add_outputniche_reuse_asset
Rendering
3 TOOLSOn-demand image card and 9:16 reel with cell-aware dimensions (1200×627 for linkedin:image_post, 1080×1350 for instagram:image_post, etc.). Idempotent replace. Or attach the creator's own photo as the post image (niche_attach_image).
niche_render_image_cardniche_render_reelniche_attach_image
Brand intelligence
7 TOOLSPersisted BrandProfile JSON (voice rules, lexicon, framing allowlist, verifier overrides). Ingest brand from URL, files, or freeform text (async — poll niche_brand_kit_ingest_status). Voice extraction from past posts. Guided-setup question chain for first-touch onboarding.
niche_brand_profile_getniche_brand_profile_setniche_brand_kit_ingestniche_brand_kit_ingest_statusniche_brand_kit_updateniche_brand_kit_guided_setupniche_voice_profile_ingest
Publishing
1 TOOLDry-run by default. Idempotency-key required for commit. Verifier-blocked outputs refuse to publish even at `dry_run=false`.
niche_draft_publish
Account + orientation
1 TOOLOne read-only call (niche_whoami) that returns the authenticated account, plan, and credit balance; the server version + endpoint + live tool count; the capability map (every tool grouped by band + the recommended flow); and the brand state, so an agent knows before a run whether a brand profile / kit / voice will shape the output.
niche_whoami