docs · connectors

use senpai in claude and chatgpt

add one url as a connector, sign in, and ask for posts from the chat. same voices, same tokens as the app.

the url

https://shitpostsenpai.com/api/mcp

it's a remote mcp server. when you connect, you sign in to shitpost senpai and click allow. you need an account; sign up first if you don't have one.

claude

  1. on claude.ai or the desktop app, open settings, then connectors.
  2. add a custom connector and paste the url above.
  3. click connect, sign in here, and allow.

claude code, from a terminal:

claude mcp add --transport http shitpostsenpai https://shitpostsenpai.com/api/mcp

then run /mcp inside claude code to sign in.

chatgpt

  1. open settings, then apps & connectors, then advanced settings, and turn on developer mode.
  2. create a connector, paste the url above, and pick oauth as the authentication.
  3. sign in here and allow. turn the connector on in a chat to use it.

other clients: api key

for a client that takes a bearer token instead of oauth, create a key in settings, ai apps and send it as a header:

Authorization: Bearer ssp_key_...

the key is shown once. treat it like a password.

what it can do

generate_post
writes post options or an article with your voices. costs tokens like the generate page: 1 per post batch, 3/5/8 for a short/medium/long article.
list_styles
platforms, tones, formats and the voices you can write as.
save_post
puts a post in your queue or drafts. nothing gets published.
favorite_post
the slaps button. teaches your voice what you like.
list_history
your saved posts, newest first.
get_generation
one saved post with its full text.

it can't post to your accounts, change your settings, or buy tokens. out of tokens means out of tokens, same as in the app.

disconnect

settings, ai apps lists every connected app and key. disconnect or revoke one and it stops working on its next request.