# Ritekit — how to use (mcp.ai)

Connect your Ritekit account and use 14 tools for social media marketing straight from your AI agent. Connect with your own API key. RiteKit offers a suite of APIs designed to enhance social media engagement by providing tools for hashtag generation, link shortening, and content analysis.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_ritekit?ms=1787291460000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `ritekit_auto_hashtag`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/ritekit`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/ritekit/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/ritekit/auto/hashtag` — Tool to automatically add relevant hashtags to a given post. Use when you have plain text and need suggested hashtags appended or inserted in context.
  - body: { post: string, maxHashtags?: integer, hashtagPosition?: string }
- `POST https://api.mcp.ai/api/ritekit/banned/instagram/hashtags` — Tool to identify which hashtags are banned on Instagram. Use when preparing content and need to filter out banned hashtags before posting.
  - body: { tags: string[], client_id?: string, access_token?: string }
- `POST https://api.mcp.ai/api/ritekit/detect/disposable/email` — Tool to detect if an email address is disposable. Use when validating email addresses to filter out temporary or fake email services.
  - body: { email: string }
- `POST https://api.mcp.ai/api/ritekit/detect/email/typo` — Tool to detect common typos in email addresses and suggest corrections. Use when validating email input to help users correct mistakes like gml.com -> gmail.com.
  - body: { email: string, client_id: string }
- `POST https://api.mcp.ai/api/ritekit/freemail/detection` — Tool to detect whether an email address belongs to a free email provider. Use when validating lead quality before ingestion.
  - body: { email: string }
- `POST https://api.mcp.ai/api/ritekit/get/access/token` — Tool to obtain a RiteKit access token. Prefer using a stored token from connection metadata or request. Falls back to OAuth2 client credentials if both client_id and client_secret are provided and no 
  - body: { client_id?: string, access_token?: string, client_secret?: string }
- `POST https://api.mcp.ai/api/ritekit/get/client/id` — Tool to retrieve stored RiteKit client_id. Use when child actions require the client_id query parameter.
  - body: { client_id?: string }
- `POST https://api.mcp.ai/api/ritekit/get/client/secret` — Tool to retrieve stored RiteKit client_secret. Use when child actions require the client_secret parameter.
  - body: { client_secret?: string }
- `POST https://api.mcp.ai/api/ritekit/get/full/email/insights` — Tool to retrieve comprehensive email address insights including full name, free mail detection, business email detection, and typo suggestions. Use when you need detailed analysis of an email address 
  - body: { email: string, client_id?: string }
- `POST https://api.mcp.ai/api/ritekit/hashtag/suggestions` — Tool to get hashtag suggestions for a given text. Use when you need relevant hashtags for social media posts.
  - body: { text: string, client_id?: string, access_token?: string }
- `POST https://api.mcp.ai/api/ritekit/link/ad/delete` — Tool to delete a link ad. Use when you need to permanently remove a link ad by its ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/ritekit/list/link/ads` — Tool to retrieve a list of link ads. Use after authenticating to fetch all link ads for the user.
  - body: { client_id?: string, access_token?: string }
- `POST https://api.mcp.ai/api/ritekit/shorten/link` — Tool to shorten a URL with a specified CTA. Use when you need to generate a call-to-action-enabled short link.
  - body: { cta: integer, url: string }
- `POST https://api.mcp.ai/api/ritekit/text/to/image` — Tool to convert a quote into a styled image. Use after preparing quote text and style options.
  - body: { quote: string, author?: string, bgType?: string, fontSize?: integer, animation?: string, brandLogo?: string, client_id?: string, quoteFont?: string, authorFont?: string, gradientType?: string, showQuoteMark?: integer, gradientColor1?: string, gradientColor2?: string, highlightColor?: string, quoteFontColor?: string, authorFontColor?: string, backgroundColor?: string, enableHighlight?: integer }

## Example prompts
- "What can I do in Ritekit?"
- "Show me a summary of my Ritekit account"

## More
- Page: https://mcp.ai/ritekit
- Agent spec (llms.txt): https://mcp.ai/ritekit/llms.txt
- Postman collection: https://mcp.ai/ritekit/postman.json