AI
MCP server
Connect ChatGPT, Claude, Cursor, Codex, or any MCP client to Distinctful with the hosted MCP server and OAuth sign-in.
MCP is an open protocol that lets AI tools use outside apps on your behalf. Distinctful hosts an MCP server, so there is nothing to install and no API key to manage.
Remote MCP server
Distinctful hosts the MCP server at:
https://app.distinctful.com/api/mcpConnect any MCP client that supports remote servers over Streamable HTTP. When you connect, your client opens a browser window where you sign in to Distinctful and approve access with OAuth.
Connect your client
Each tab matches the setup on that client’s page.
- In Claude on the web or desktop, open Customize, then Connectors, and choose Add custom connector.
- Paste the server address, sign in to Distinctful, and approve access.
- Turn the connector on in a chat and ask Claude to plan your week.
https://app.distinctful.com/api/mcpSee the Claude page.
- In ChatGPT, open Settings, then Apps, and find Distinctful in the directory.
- Choose Connect, sign in to Distinctful, and approve access.
- In a chat, pick Distinctful from the + menu or type @Distinctful, then ask it to plan your week.
https://app.distinctful.com/api/mcpSee the ChatGPT page.
- Add the server with the command below.
- Run /mcp in Claude Code, choose distinctful, then sign in and approve access.
- Ask Claude Code to draft a post about the change you just made.
claude mcp add --transport http distinctful https://app.distinctful.com/api/mcpSee the Claude Code page.
- Choose Add to Cursor, or add the server below to ~/.cursor/mcp.json.
- Open Cursor Settings, then Tools & MCP, choose Connect next to distinctful, sign in, and approve access.
- Ask the agent to draft a post about what you shipped.
{
"mcpServers": {
"distinctful": {
"url": "https://app.distinctful.com/api/mcp"
}
}
}See the Cursor page.
- Add the server with the command below.
- Run codex mcp login distinctful, sign in to Distinctful, and approve access.
- Ask Codex to draft a post about what you shipped. The Codex app and CLI share the connection.
codex mcp add distinctful --url https://app.distinctful.com/api/mcpSee the Codex page.
- On grok.com, open Connectors, choose New Connector, then Custom.
- Paste the server address, sign in to Distinctful, and approve access.
- In a chat, ask Grok to plan your week or save an idea.
https://app.distinctful.com/api/mcpSee the Grok page.
- Add the server below to ~/.gemini/settings.json.
- Start Gemini CLI and run /mcp auth distinctful, then sign in and approve access.
- Ask Gemini to plan your week or draft a post.
{
"mcpServers": {
"distinctful": {
"httpUrl": "https://app.distinctful.com/api/mcp",
"oauth": {
"enabled": true
}
}
}
}See the Gemini page.
- In Perplexity, open Account settings, then Connectors, and choose Custom connector, then Remote.
- Paste the server address, choose OAuth, sign in to Distinctful, and approve access.
- Turn the connector on in a thread and ask Perplexity to plan your week.
https://app.distinctful.com/api/mcpSee the Perplexity page.
- In Muse, open Connectors and search for Distinctful.
- Choose Connect, sign in to Distinctful, and approve access.
- Ask Muse to plan your week or save an idea.
See the Muse by Meta page.
- Add the server below under mcp_servers in ~/.hermes/config.yaml.
- Run hermes mcp login distinctful, sign in to Distinctful, and approve access.
- Start Hermes and ask it to plan your week or save an idea.
mcp_servers:
distinctful:
url: "https://app.distinctful.com/api/mcp"
auth: oauthSee the Hermes page.
- In VS Code, add the server below to .vscode/mcp.json, or run MCP: Add Server from the Command Palette and choose HTTP.
- Start the server, sign in to Distinctful when VS Code asks, and approve access.
- In Copilot Chat, switch to agent mode and ask it to draft a post about what you shipped.
{
"servers": {
"distinctful": {
"type": "http",
"url": "https://app.distinctful.com/api/mcp"
}
}
}See the GitHub Copilot page.
Sign-in and access
The consent screen lists what your client can do before you approve it. MCP access is included on the Grow plan and higher. Sessions refresh on their own for clients that support it; others ask you to approve again after an hour.
A connection works in the workspace you were in when you approved it, and reads times in that workspace's home time zone unless you name another. To use the same client with another workspace, revoke it, switch workspace in Distinctful, and connect again.
Planning and scheduling posts
Connected tools can create or edit a draft, attach images and videos, then schedule it or publish it now on the accounts you name, and cancel a scheduled post. To review first, ask your tool to plan it onto your calendar, then schedule it yourself in Distinctful. An edit never changes a post already scheduled until it is scheduled again. See every MCP tool for the full list of what a client can read and write.
Limits and retries
Each workspace allows 30 reads, 20 writes, and 10 removals or posts a minute across all connected tools. Limit, retry, and posting errors come back as JSON with a code, so your client knows whether to wait or stop.
RATE_LIMITEDOver the limit. Wait retryAfterSeconds, then retry.LIMITER_UNAVAILABLELimits could not be checked, so nothing ran. Retry shortly.IN_PROGRESSA call with this idempotencyKey is still running. Retry with the same key.IDEMPOTENCY_KEY_REUSEDThe key was used for a different request. Use a new key.NOT_SENTA post was not scheduled or published. The message says why; retry after retryAfterSeconds when it is set.DRAFT_IN_USEA teammate has this draft open in Distinctful, so nothing changed. Retry after retryAfterSeconds.Tools that create something accept an idempotencyKey. Send a new key for each new write and the same key when you retry one. If the first call went through, Distinctful returns its original result instead of creating a duplicate.
Revoke access
Open Settings in Distinctful, go to Integrations, and revoke the client under connected agents. Access ends within a minute.