// 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

Seventeen in total. Free accounts get sixteen; competitor search is pro.

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.
list_saved_posts	Everything you've saved, newest first, filterable by platform, tag or save date.
get_saved_post	One saved post in full, with your notes and its media description.
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_post_performance	Your posts in a date window, ranked by engagement. Ranking competitors' posts is pro.
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
prepare_voice_context	Your current profile, a sample of your posts, and what a good profile covers. Run it before writing or updating the profile.
get_voice_profile	Read the voice profile back.
save_voice_profile	Store a voice profile your own model wrote.
refresh_profile	Re-import a tracked profile on demand. Refreshing a competitor is pro.

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

Marking a draft published is web-app only. Publishing is outward-facing, so it doesn't belong 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/…	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: scheduled re-imports are not switched on yet, so your data is as current as your last refresh. Competitor search, ranking competitors' posts, and refreshing a competitor are pro.