--- title: "OneUp Today MCP Server | Use it inside Claude, ChatGPT and Cursor" description: "OneUp Today is an MCP server with 102 tools. Connect it to Claude, Claude Code, Cursor, ChatGPT or Grok and run your Reddit lead agents, draft DMs in your voice, publish posts and drive your SEO agent from a chat." url: https://oneup.today/mcp --- Model Context Protocol # Use OneUp Today inside Claude, ChatGPT and Cursor OneUp Today is an MCP server: plug it into your AI assistant and it can run your Reddit lead agents, draft DMs in your voice, publish posts and drive your SEO agent, all in the chat you are already in. Every send still needs your approval. 102 tools 7 agents $0 connector $3 free credit Connect ## One URL, and your assistant can run your marketing MCP (Model Context Protocol) is the standard that lets AI assistants use external tools. Add the URL below to Claude, Cursor, Claude Code, Grok or any MCP client, and when you ask about your leads, conversations or posts it pulls your real OneUp Today data instead of guessing. `https://api.oneup.today/mcp_apis/mcp/` [Get your API key](https://app.oneup.today/connections) Your key is on the Connections page. It is password-equivalent, so do not paste it anywhere public. Using ChatGPT? It has its own endpoint, https://apps.oneup.today/mcp, which signs in with OAuth so there is no key to copy. It carries a curated 25-tool subset. Everything else uses the URL above. Setup ## How to connect 1. Copy your connector URL from the [Connections page](https://app.oneup.today/connections). It contains your API key, so treat it like a password. 2. In Claude, open Settings, then Connectors, scroll to the bottom and click Add custom connector. 3. Name it OneUp Today, paste the URL, and click Add. 4. Enable it in a chat and try: List my agents. Works the same in Claude web and Claude Desktop. There is a Claude-specific walkthrough with screenshots on the [Claude connector page](https://oneup.today/claude). One command. The header form keeps your key out of the URL and out of your shell history if you use a variable for it. `claude mcp add --transport http oneup https://api.oneup.today/mcp_apis/mcp --header "X-API-Key: "` Swap for the key on your [Connections page](https://app.oneup.today/connections). Then ask Claude Code to check your outreach readiness before it drafts anything. Add OneUp Today to your MCP config (Settings, then MCP, then Add new global MCP server), or drop this into .cursor/mcp.json in a project. `{ "mcpServers": { "oneup": { "url": "https://api.oneup.today/mcp_apis/mcp", "headers": { "X-API-Key": "" } } } }` The same JSON works in Zed, Windsurf, and anything else that takes an mcpServers block with a remote HTTP URL. The one route with no key to copy. ChatGPT signs in to your OneUp Today account directly. `https://apps.oneup.today/mcp` 1. Open Settings, then Apps & Connectors. Turn on Developer mode if you do not see custom connectors. 2. Add a connector with the URL above and choose OAuth authentication. 3. Sign in with your OneUp Today account and approve access. This is a curated 25-tool surface covering agents, leads, conversations, and DM drafting. For posting, scheduling, and the SEO agent, use one of the other clients. 1. Open Grok on grok.com or in the X app, then Settings, then Connectors. 2. Add an MCP server or custom connector. 3. Name it OneUp Today, paste your connector URL from the [Connections page](https://app.oneup.today/connections), and set transport to HTTP. Naming the connector in your question helps Grok pick it up the first time, for example: using the OneUp Today connector, which leads replied this week? Add an MCP server with transport http (streamable) and URL https://api.oneup.today/mcp\_apis/mcp. The server is stateless JSON-RPC 2.0 and negotiates protocol versions 2024-11-05, 2025-03-26 and 2025-06-18. Authenticate with your API key in any of three places: the URL path (/mcp\_apis/mcp/), an X-API-Key header, or an ?api\_key= query parameter. The header is the safest. Machine docs: [GET /mcp\_apis/mcp](https://api.oneup.today/mcp_apis/mcp) is public and returns the server info plus the live tool list, no key needed. There is also [/llms.txt](https://oneup.today/llms.txt). Capabilities ## What your assistant can do 102 tools, grouped by the agent they belong to. Every one runs against your own account with your company ownership, and every write is logged to the activity tab. ### Lead Agent Who is worth talking to, what they scored, and why. get\_lead\_statslist\_leads\_by\_statusexplain\_lead\_scoreadd\_lead\_notes ### Messaging Agent Reddit DM drafts in your voice, full threads, and the send decision. draft\_reddit\_dmregenerate\_draftsend\_draftsearch\_conversations ### Reply Agent Public replies drafted, chosen, queued, and posted. list\_reply\_draftsselect\_replypost\_replycancel\_queued\_reply ### Content Agent Posts and build-in-public, from your commits or a one-line note. create\_postdraft\_posts\_from\_commitsdraft\_post\_from\_changescreate\_schedule ### SEO Agent Keyword plan through to a published article, with Google and Bing ranks. seo\_build\_keyword\_planseo\_generate\_article\_nowseo\_get\_ranksseo\_backlinks ### Chatbot Agent The Front Desk widget on your own site: what visitors asked, and your reply. get\_frontdesk\_statuslist\_frontdesk\_conversationsfrontdesk\_replysetup\_front\_desk ### Agents and runs Create, configure, run, pause, and read the run history of any agent. list\_agentscreate\_agentrun\_agent\_nowget\_run\_details ### Account and readiness Who you are, what is connected, and whether a send will actually go out. whoamiget\_outreach\_readinesslist\_socialssearch\_help That is a map, not the full inventory. For the live list, [GET /mcp\_apis/mcp](https://api.oneup.today/mcp_apis/mcp) is public and returns every tool name, no key needed. Try it ## Things to ask - Which of my Reddit leads replied this week, and which are still waiting on me? - Draft a DM for this post in my voice, then show me before anything sends. - Is my outreach ready to send right now, or will it only draft? - Turn this week's commits into three build-in-public posts. - What is my SEO agent publishing next, and what is it ranking for so far? - Pause the messaging agent and tell me why its reply rate dropped. Honest about sending ## What still needs the Chrome extension Reddit blocks server-side sending, and we will not work around that by logging into your account from a server. So the connector does everything up to the send, and the [Chrome extension](https://oneup.today/chrome-extension) does the send itself, from your own logged-in browser. ### Works from the chat Create, configure, run, pause and resume agents. Read leads, conversations, drafts and analytics. Draft DMs and replies. Move leads through your funnel. Queue posts and schedules. Run the SEO agent end to end. ### Needs your browser Actually sending a Reddit DM or reply, and warming the discovery pool. Ask for get\_outreach\_readiness and your assistant will tell you whether a run will send now or only draft. Fair use ## Limits and what costs money The connector is free and included with your account. Reads and configuration changes cost nothing. Only actions with a published price debit your balance, the same prices you see in the app, so a chat can never spend more than a click would. See [pricing](https://oneup.today/pricing). Rate limits are 60 requests a minute per key, then per class: 60 reads, 20 writes, and 10 generations a minute. Enough for any real conversation, not enough to bulk-export your own account through a chat window. At a glance OneUp Today's MCP server exposes 102 tools to any AI assistant, free with every account. - OneUp Today is an MCP (Model Context Protocol) server. It exposes 102 tools to any MCP client, covering all seven agents: Lead, Messaging, Reply, Content, SEO, Email, and Chatbot. - There are two endpoints. Claude, Claude Code, Cursor, and Grok use https://api.oneup.today/mcp\_apis/mcp with your personal API key. ChatGPT uses https://apps.oneup.today/mcp and signs in with OAuth, so there is no key to copy. - The connector itself is free and included with every OneUp Today account. Reads and configuration changes cost nothing; only actions with a published price debit your balance. - Transport is streamable HTTP with stateless JSON-RPC 2.0, supporting MCP protocol versions 2024-11-05, 2025-03-26, and 2025-06-18. - Rate limits are 60 requests a minute per key, then per class: 60 reads, 20 writes, and 10 generations a minute. - Reddit sends still go out through the OneUp Today Chrome extension from your own logged-in browser. The connector drafts and queues; it never logs in as you. ## Questions, answered ### Why are there two different URLs? Because the two clients authenticate differently. Claude, Claude Code, Cursor, and Grok use `https://api.oneup.today/mcp_apis/mcp` with your personal API key, and get all 102 tools. ChatGPT connects to `https://apps.oneup.today/mcp`, which runs OAuth so you never handle a key, and exposes a curated 25-tool subset. The ChatGPT OAuth server only accepts ChatGPT's own callback URLs, so it cannot be used from Claude or Cursor. ### Does the connector cost anything? No. The connector is free and included with every account, and every new account starts with $3 of credit. Reading your leads, conversations, runs, and settings is free. Only actions with a published price, like an agent run or a generated article, debit your balance. See [pricing](https://oneup.today/pricing). ### The URL contains my API key. Is that safe? Treat it like a password: anyone holding it can act on your account. Prefer the header form where your client supports it, which is what the Claude Code and Cursor instructions above use, so the key never sits in a URL or a shell history. You can rotate the key any time from the Connections page. ### Does it work in Cursor and other MCP clients? Yes. The server speaks streamable HTTP with stateless JSON-RPC 2.0 and negotiates MCP protocol versions 2024-11-05, 2025-03-26, and 2025-06-18, so any compliant client works. `GET https://api.oneup.today/mcp_apis/mcp` is public and returns the server info and the live tool list if you want to check before connecting. ### How is this different from the CLI? Same backend, same account, same tools, different surface. The connector lives inside a chat; the [CLI](https://oneup.today/cli) lives in your terminal and works with any agent or script. They share one API key, so use whichever fits the moment. ### Can it send Reddit DMs on its own? No, and that is deliberate. The connector drafts, scores, and queues. Actual Reddit sends go out through the [Chrome extension](https://oneup.today/chrome-extension) from your own logged-in browser session, so no server-side bot ever logs in as you. Ask for `get_outreach_readiness` to see whether a send will go out now or be queued. Prefer a terminal? The [OneUp Today CLI](https://oneup.today/cli) wraps the same tools for your shell and your coding agent. ## Give your assistant a marketing team Start free with $3 of credit, grab your key, and paste one URL. Your agents, leads and drafts are in the next chat you open. [Get your API key](https://app.oneup.today/connections)