Pagerankcafe

com.pagerankcafePublished by pagerankcafe.comv0.1.3Updated Oct 24, 2026

PageRankCafe MCP server: create and post ads, read performance, query platform insights.

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

PageRankCafe MCP server lets an AI assistant read ad performance and, on paid plans, create and post link, banner, YouTube and press-release ads.

What you can do
Check API connectivity, account membership, credit balance and referral stats, and list active link, banner, YouTube and press-release ads with per-placement performance. Upload an image and get a hosted URL. Create and update link, banner, YouTube and press-release ads. Post existing ads into rotation using credits. Pull trailing-30-day platform-wide performance aggregates and current prices on paid tiers.
When to use it
Useful when you run PageRankCafe advertising and want an assistant to review campaign performance, check credits, or draft and publish new ads without leaving the chat. Read-only use works on a free account; creating and posting ads needs a paid membership.
Requirements
Runs locally via npx (Node.js). Requires a PageRankCafe account and an API key in PAGERANKCAFE_API_KEY, which the server needs at startup. Optional PAGERANKCAFE_BASE_URL overrides the API endpoint. Network access to pagerankcafe.com. Account creation and key generation are manual website steps.
Before you install
The API key is a secret passed in an environment variable. Write tools create and post ads and consume credits, which may involve spending; posting can also return pending status when approval is needed. Uploaded images are sent to PageRankCafe and hosted there. Paid-tier tools fail on free accounts.

Installation

In SourceWeft

  1. Open Pagerankcafe in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

pagerankcafe-mcp

The marketing platform for your AI agents.

An MCP (Model Context Protocol) server for the PageRankCafe API. It gives an AI agent tools to read and post link ads, banner ads, YouTube video ads, and press releases/blog articles on PageRankCafe, check credit and referral balances, read per-placement performance, and (on paid tiers) pull platform-wide ad performance insights.

Getting a key

  1. Create a PageRankCafe account at https://pagerankcafe.com.
  2. Upgrade to a paid membership (Bronze/Silver/Gold) at https://pagerankcafe.com/membership-info if you want to use the write and insights tools. Read tools work on a free account too.
  3. Generate an API key at https://pagerankcafe.com/apiKeys.

Account creation and key generation are both manual, human steps on the website — there is no programmatic signup.

Configuration

The server reads its configuration from environment variables:

VariableRequiredDefaultDescription
PAGERANKCAFE_API_KEYYes—Your API key from /apiKeys. The server exits immediately with an error if this is not set.
PAGERANKCAFE_BASE_URLNohttps://pagerankcafe.comAPI base URL. Override only for testing against a non-production environment.

Install

Claude Desktop

Add to your claude_desktop_config.json:

json
{  "mcpServers": {    "pagerankcafe": {      "command": "npx",      "args": ["-y", "pagerankcafe-mcp"],      "env": {        "PAGERANKCAFE_API_KEY": "your-api-key-here"      }    }  }}

Claude Code

bash
claude mcp add pagerankcafe --env PAGERANKCAFE_API_KEY=your-api-key-here -- npx -y pagerankcafe-mcp

Cursor

Add to your Cursor MCP settings (~/.cursor/mcp.json or the project's .cursor/mcp.json):

json
{  "mcpServers": {    "pagerankcafe": {      "command": "npx",      "args": ["-y", "pagerankcafe-mcp"],      "env": {        "PAGERANKCAFE_API_KEY": "your-api-key-here"      }    }  }}

Tools

Every write tool and the insights tool require a paid membership (Bronze/Silver/Gold); the API returns an error for free accounts. Read tools work on any valid key, including free accounts.

ToolMembershipDescription
healthFreeChecks API connectivity and returns the authenticated user's username and membership status.
list_linksFreeLists your active link ads.
list_bannersFreeLists your active banner ads.
list_youtube_adsFreeLists your active YouTube video ads.
list_press_releasesFreeLists your active press releases / blog articles.
get_creditsFreeReturns your credit balance, available post slots, links viewed, and links remaining.
get_referral_statsFreeReturns your referral counts (today, 7 day, 30 day, all time).
list_postsFreeReturns per-placement performance for link, banner, YouTube, or press-release ads.
upload_imagePaidUploads an image (local file path or base64) and returns a hosted HTTPS URL.
create_bannerPaidCreates a new banner ad.
post_bannerPaidPosts an existing banner into rotation using credits.
create_youtube_adPaidCreates a new YouTube video ad.
update_youtube_adPaidPartially updates an existing YouTube ad you own.
create_press_releasePaidCreates a new press release / blog article.
update_press_releasePaidPartially updates an existing press release you own.
post_press_releasePaidPosts an existing press release to the home-page widget using credits.
create_linkPaidCreates a new link ad.
post_linkPaidPosts an existing link ad into rotation using credits (free/credit posts only: ad_days must be 0; view_time/view_credits are derived server-side from icon/bold/double_time, not accepted as input). Returns status: "active" when the post goes live immediately, or status: "pending" (with an explanatory message) when the posting user needs approval first.
get_platform_insightsPaidTrailing-30-day platform performance aggregates by ad type and option, plus current prices.

Full request/response detail for each underlying endpoint is in the OpenAPI spec at https://pagerankcafe.com/api/spec (rendered at https://pagerankcafe.com/api/docs).

Error handling

Every tool returns the API's JSON response as the tool result on success. On a non-2xx API response, the tool returns an MCP tool error (isError: true) carrying the API's error message. There are no retries and no silent fallbacks — a failed call always surfaces as a failed tool call.

Development

bash
npm installnpm run build   # compiles src/ to dist/ with tscnpm test        # builds, then runs the stdio smoke test (no network required)

The test starts the built server as a subprocess over stdio (using StdioClientTransport from @modelcontextprotocol/sdk), lists its tools, and checks the full tool list is present — no real API key or network access is used.

Source: README.md at commit 92ac828

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts