MCP

Rankhog exposes paid agent capabilities through MCP.

Use MCP when an AI client supports OAuth and should call named tools instead of raw REST endpoints. The same capability registry backs MCP, REST, and the CLI.

Endpoint

https://api.rankhog.com/mcp

For local development, use your local API origin:

http://localhost:48738/mcp

OAuth Discovery

curl https://api.rankhog.com/.well-known/oauth-authorization-server
curl https://api.rankhog.com/.well-known/oauth-protected-resource/mcp

Client Config

{
  "mcpServers": {
    "rankhog": {
      "url": "https://api.rankhog.com/mcp"
    }
  }
}

Your client redirects through Rankhog sign-in and OAuth consent.

Tools

Core tools:

• Get Agentic Actor: inspect the current actor and scopes.
• List Agentic Workspaces: get organization, website, and managed account IDs.
• Get Subreddit Rules: fetch verified or live subreddit rules.
• Get Subreddit Activity: read cached activity and optionally refresh through Desktop.
• Get Reddit Browser Status: check whether Desktop is ready.
• Open Reddit URL: open an allowed Reddit URL in the paired Desktop browser.
• Get Workspace Strategy Plan: read the current strategy plan.
• Get Workspace Strategy Activity: read recent strategy activity.
• Get Planned Reddit Action: inspect a planned action.
• Create Reddit Post Draft: create a ready manual draft for a human to post.
• Create Reddit Action: store a post, comment, reply, upvote, or join_subreddit action.
• Execute Reddit Action: queue an approved stored action for Desktop execution.
• Get Reddit Action Execution Status: poll queued, running, succeeded, failed, blocked, cancelled, or verification-required executions.
• Get Control Pane Analytics Summary: read cached workspace analytics.
• Get Job and List Planned Jobs: inspect background work.
• Legacy Dangerous Reddit Post Submit: compatibility path for old clients. New clients should use execute_reddit_action.

Agent Recipe

Create or select a planned action, execute it with idempotency, then poll status.

{
  "tool": "list_agentic_workspaces",
  "arguments": {}
}

{
  "tool": "create_reddit_action",
  "arguments": {
    "organizationId": "org_...",
    "managedRedditAccountId": "acct_...",
    "actionType": "comment",
    "targetUrl": "https://www.reddit.com/r/SaaS/comments/examplepost/example/",
    "body": "We saw better activation after asking users for one setup action instead of showing a long checklist.",
    "riskSummary": "Contextual reply with no link and no promotional claim.",
    "idempotencyKey": "action-comment-2026-06-17-001"
  }
}

{
  "tool": "execute_reddit_action",
  "arguments": {
    "organizationId": "org_...",
    "managedRedditAccountId": "acct_...",
    "plannedRedditActionId": "act_...",
    "acknowledgement": "I understand this can publish or change Reddit state from the user's Reddit account.",
    "idempotencyKey": "execute-action-2026-06-17-001"
  }
}

The execute response is immediate:

{
  "status": "queued",
  "executionId": "job_...",
  "jobId": "job_...",
  "plannedRedditActionId": "act_...",
  "statusUrl": "/agent/v1/reddit-action-executions/status?executionId=job_..."
}

Poll until terminal:

{
  "tool": "get_reddit_action_execution_status",
  "arguments": {
    "organizationId": "org_...",
    "managedRedditAccountId": "acct_...",
    "executionId": "job_..."
  }
}

Terminal statuses are succeeded, failed, blocked, cancelled, and verification_required.

If status is verification_required, do not call execute_reddit_action again automatically. Reddit may already have accepted the write.

Scopes

Request the smallest set of scopes your client needs.

rankhog:read
reddit:rules:read
reddit:activity:read
browser:read
reddit:draft:write
reddit:write:dangerous

Requirements

MCP calls require:

• A signed-in Rankhog user.
• Membership in the target organization.
• An active or trialing website subscription.
• The target managed Reddit account ID.
• Rankhog Desktop when a browser-backed tool needs Reddit.

Dangerous writes also require explicit acknowledgement, idempotency, rate limits, Desktop readiness, and the reddit:write:dangerous scope.

MCP clients never receive raw browser control. Rankhog Desktop receives versioned high-level workflows after server-side validation.

Next: use REST for HTTP automation or the CLI for scripts.