Login

Simpliers Giveaway MCP Server

The Simpliers remote MCP server runs over HTTP transport and authorizes with OAuth. From any MCP client a giveaway can be set up, a post checked and the result page link picked up.

Server address

https://api.simpliers.com/mcp/giveaway

Server Details

Server name
Simpliers Giveaway
Transport
HTTP (MCP, Model Context Protocol)
Authentication
OAuth. Access is granted on the Simpliers consent screen.
Sign-in
With a Simpliers account, or without creating one.

Connecting via Connector

Clients with a connector list carry Simpliers Giveaway in that list. The browser opens the Simpliers consent screen, and after approval it returns to the client with the tools listed.

A step by step walkthrough with screenshots, using Claude as the example, is in the Instagram giveaway with AI guide.

Manual Setup

Clients without a connector list take the server by its address. Authorization still runs over OAuth, and the consent screen still lives on Simpliers.

Claude Code

The first command adds the server, the second opens the consent screen in the browser. After approval the claude mcp list row reads Connected; inside a session the /mcp menu grants access too.

claude mcp add --transport http simpliers-giveaway https://api.simpliers.com/mcp/giveaway
claude mcp login simpliers-giveaway
Cursor

Add it to ~/.cursor/mcp.json, or to .cursor/mcp.json for a single project. As soon as Cursor sees the server it opens the browser for approval, then lists the tools.

{
  "mcpServers": {
    "simpliers-giveaway": {
      "url": "https://api.simpliers.com/mcp/giveaway"
    }
  }
}
VS Code

Add it to .vscode/mcp.json in the workspace; starting the server sends the browser to the consent screen.

{
  "servers": {
    "simpliers-giveaway": {
      "type": "http",
      "url": "https://api.simpliers.com/mcp/giveaway"
    }
  }
}
Other MCP clients

Enter this as the server address in the client's MCP setup screen, and OAuth handles the rest.

https://api.simpliers.com/mcp/giveaway

OAuth Flow

  1. Access is requested

    A freshly added server has no access yet. Running the approval command opens the Simpliers consent screen in the browser. On a remote machine with no browser the command prints the address to open, and the address it hands back after approval is pasted into the command.

  2. The identity is chosen

    With a Simpliers session open in the browser, the consent screen comes up right away. Without one, the choice is signing in or continuing without an account.

  3. The consent screen is approved

    The screen carries the name of the connecting client, the account it continues with and the permissions granted.

  4. The connection is verified

    The browser returns to the client, the server list reads Connected, and the Simpliers tools become callable.

  5. The first call runs

    Given a post link, the client checks the post through Simpliers, suggests rules and pulls the comments once approved.

Example Prompts

Once the connection is live, the giveaway is set up in conversation. The lines below work with your own post link.

Starting a comment giveaway

Run a giveaway from https://www.instagram.com/p/DY7bRCnD1-j/ with 1 winner and 2 backups.

The client checks the post and pulls the comments; the number of winners and backup winners comes back for approval.

Picking a post from a profile

List the latest posts from https://www.instagram.com/simpliers/ so I can decide which one to run the giveaway on.

The latest posts are listed and it asks which one you meant. The client never picks the post on its own.

Adding rules

Only count comments that tag at least 2 people, and add a follow requirement.

Sets the Minimum Tag Count and adds the follow rule. The follow rule is verified on Instagram and X giveaways.

An X giveaway

Run a giveaway from the retweets and replies on https://x.com/simpliershello/status/1886789674112315729.

Retweets and replies are collected, and what counts as an entry comes back for approval.

Getting the result

Are the comments collected? Send me the result page link.

It reports how many entries were pulled and gives the result page link. The winner is picked there, in your own browser.

Permissions on the Consent Screen

The consent screen carries the name of the connecting client and the account it continues with. The permissions granted:

  • Posts and giveaways: Reads your posts, your giveaways and their results.
  • Starting giveaways: Starts giveaways on your behalf. Connected with an account, it draws on your giveaway credits and subscription; connected without one, on the credits earned in this browser.
  • Rule checks: Checks whether the winners meet your rules.
  • Picking the winner stays with you: The draw always runs on the result page, in your own browser.

Supported Platforms

The client checks the post through Simpliers and reports what can be collected on that platform.

Platform Collected
Instagram Comments
TikTok Comments
YouTube Comments
X (Twitter) Retweets and replies
  • On Instagram entries are counted from comments, so a like giveaway is not possible.
  • The follow rule is verified on Instagram and X giveaways.
  • Given a profile link, the latest posts are listed and it asks which one you meant.

Picking the Winner

You pick the winner. Once the entries are in, the client gives the result page link and the draw runs there, in your own browser.

  • Anyone can verify it: Everyone who opens the result page sees the rules, the entry count and the giveaway code.
  • The link knows you for 7 days: Use the link the client gives exactly as it is; the code at the end is what makes the page recognise you.

Pricing and Payment

  • A giveaway on a post that has never been drawn before is free.
  • Giveaways covering more than one post run on a giveaway credit or a subscription.
  • Payment happens on the Simpliers checkout page, and the client hands over that link.

Disconnecting

Connected with an account, the connected clients are listed on your account info page. Disconnecting also revokes the client's token.

Connected without an account, the connection is removed from the client itself; the account panel lists only connections made with an account.

Your giveaways, giveaway credits and result pages stay on Simpliers regardless of the connection.

How the data is handled is written out in the Privacy Policy.

Support

If the connection fails or a tool does not behave as expected, write to Simpliers support.