AI
MCP server
Connect Claude, Codex, Muse by Meta, 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.
- 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.
- 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.
- 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.
- 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.
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.
Planning posts
Connected tools can create a draft and plan it onto your calendar for a date and platforms. Open it in Distinctful to schedule it. See every MCP tool for the full list of what a client can read and write.
Limits and retries
Each Distinctful allows 30 reads, 20 writes, and 10 removals a minute across all connected tools. Every error comes 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.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.