// docs.mcp

The Sosensus MCP server.

Connect Sosensus to Claude, Cursor, or any MCP client. Your client can then search everything you have published, load the voice profile built from your own writing, and keep a draft open across conversations.

The server supplies context and holds state. It does not compose, so the writing happens in your client on your preferred model.

Connect it

ENDPOINT

https://sosensus-mcp.njogued.workers.dev/mcp

// a custom domain is coming; this URL works today

You need a Sosensus account. Sign-in checks the email against existing accounts, so sign up first if you haven't.
Add a custom connector in your client and paste the URL above. In Claude that is Settings › Connectors › Add custom connector.
Enter the email on your Sosensus account. We send a six-digit code to that inbox; it is valid for ten minutes.
Enter the code. That is the whole flow. There is no password to manage, no API token to paste into a config file, and nothing to install.

Everything is scoped to your account.

Tools

Fourteen in total, twelve of them working.

Retrieval

tool	what it does
list_my_profiles	The profiles you track, with platform, relationship, and when each last synced.
search_saved_posts	Search posts you've saved from elsewhere. Matches content, your notes, and the author's name.
search_my_posts	Semantic search across everything you've published, so a post is findable by what it was about.
search_competitor_postspro	The same search over the accounts you track as competitors.
get_profile_metricsnot yet live	Engagement history for a tracked profile.
prepare_draft_context	One call returning your voice profile, your relevant posts, competitor examples and the platform guide. Run it before composing.

Draft workspace

tool	what it does
save_draft	Store a draft with its platform, topic and the context that informed it. Only ever on your explicit say-so.
list_drafts	Your drafts, newest first. Defaults to work in progress; pass status='all' to span every status.
get_draft	One draft in full, by id.
update_draft	Refine a draft in place, keeping the same id.
discard_draft	Mark a draft as discarded.

Voice and actions

tool	what it does
get_voice_profile	Read the voice profile back.
save_voice_profile	Store a voice profile your own model wrote.
refresh_profilenot yet live	Re-scrape a tracked profile on demand.

Draft search is exact-match, not semantic. Posts are embedded; drafts are not, yet. So list_drafts finds a draft by its topic and content as written, and can miss one filed under different wording. Try more than one phrasing before concluding a draft doesn't exist.

Deliberately absent

Publishing and rating a draft are web-app only. Publishing is outward-facing, and a rating is a judgement worth making at a screen, so neither belongs behind a tool call. There is no delete tool of any kind, and no tool that connects to a profile.

Resources

Five, attachable directly in clients that support resources.

uri	what it is
sosensus://user/voice-profile	Your voice profile, attachable to any writing task, including emails, comments, or anything outside the platforms you track.
sosensus://user/recent-drafts	Your most recent drafts, for picking up where you left off.
sosensus://guides/…unwritten	Per-platform best-practice guides for LinkedIn, X and Instagram.

How to use it well

The server ships instructions that tell your client roughly this, but it is worth knowing yourself:

Check for existing work first. Ask it to list your drafts before starting something new.
Prepare context before composing. One prepare_draft_context call gets you voice and content samples.
Iterate in the conversation. Nothing saves automatically.
Save when you're done. You can then refine in place on later days, rather than saving a fresh copy each time.

Current limits

Worth knowing before you rely on it: refresh_profile and get_profile_metrics are not live yet, so refreshes happen in the dashboard. The platform guides are unwritten. Scheduled re-imports are designed but not switched on, so your data is as current as your last refresh. Competitor search and profile metrics are gated to the pro tier.