⚡ MCP Protocol v2024-11-05 🌐 REST API v1.0 🟢 Live & Operational

Notify Show API & MCP Gateway

Universal programmable interface for Developers, Content Creators, and AI Agents (Claude Desktop, Cursor, Antigravity). Read articles, track creator earnings, search content, and publish posts automatically.

🚀 Authentication & Base URL

All standard REST endpoints are located under the root path:

BASE_URL: https://notify.show/api/v1

Public Endpoints

Feed, posts, search, user profiles, and platform statistics require no authentication and are open to the web.

Authenticated Actions

Publishing under your creator profile and querying earnings require passing a Bearer token or API key in the request header:

Authorization: Bearer <YOUR_API_TOKEN>

Or as a custom header: X-API-Key: <YOUR_API_TOKEN>

GET /api/v1/feed Get published articles feed with pagination

Parameter	Type	Default	Description
`page`	integer	1	Page number
`limit`	integer	15	Items per page (max: 50)

GET /api/v1/posts/{id_or_slug} Fetch full article details and formatted content

Parameter	Type	Required	Description
`id_or_slug`	string	Yes	Numeric post ID or full URL slug

GET /api/v1/search?q={query} Search articles by keywords

Parameter	Type	Required	Description
`q`	string	Yes	Search keywords or topic
`limit`	integer	No	Max items (default: 15)

GET /api/v1/users/{username} Get public user profile, total views, and articles

POST /api/v1/posts Publish a new article to Notify Show

Accepts JSON body: { "title": "...", "content": "...", "image": "..." }

curl -X POST https://notify.show/api/v1/posts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"title": "Automated Post", "content": "Hello from API!"}'

GET /api/v1/feed/personal Customized personal feed of articles from creators you follow (Requires Auth)

Requires Authorization: Bearer YOUR_TOKEN or ?api_key=...

PUT /api/v1/posts/{id} Update title, content, or cover image of an article you authored (Requires Auth)

JSON payload: { "title": "New Title", "content": "Updated content..." }

curl -X PUT https://notify.show/api/v1/posts/1 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"title": "Updated Title", "content": "Revised text..."}'

DELETE /api/v1/posts/{id} Permanently remove an article you authored (Requires Auth)

curl -X DELETE https://notify.show/api/v1/posts/1 \
  -H "Authorization: Bearer YOUR_TOKEN"

POST /api/v1/users/{id}/follow & unfollow Follow or unfollow a creator (Requires Auth)

Supports URL user ID or body {"user_id": 5} or {"username": "blackmoon"}

curl -X POST https://notify.show/api/v1/users/5/follow \
  -H "Authorization: Bearer YOUR_TOKEN"

GET /api/v1/stats Platform metrics (total posts, total views, registered creators)

🤖 What is Model Context Protocol (MCP)?

Notify Show natively implements the open standard Model Context Protocol (MCP) over HTTP JSON-RPC 2.0. AI models like Claude, Cursor, and Antigravity can connect directly to Notify Show to read the feed, retrieve articles, perform searches, check creator revenue, and publish blog posts autonomously.

MCP_ENDPOINT: https://notify.show/api/mcp

⚙️ Client Configuration Snippets

Add this entry to your ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "notify-show": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-fetch",
        "https://notify.show/api/mcp"
      ]
    }
  }
}

In Cursor: Go to Settings > Features > MCP Servers > Add New MCP Server:

Name: notify-show
Type: sse / http
URL: https://notify.show/api/mcp

Add to mcp_config.json under your Antigravity agent configuration:

{
  "mcpServers": {
    "notify_show": {
      "type": "http",
      "url": "https://notify.show/api/mcp"
    }
  }
}

Direct JSON-RPC 2.0 handshake using cURL:

curl -X POST https://notify.show/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

🛠️ Official MCP Tools Catalog

notify_get_feed Read

Retrieve latest published posts with summaries, author profiles, and view counters.

limit (int, 1-50), page (int)

notify_get_post Read

Fetch complete post content, rendered HTML, plain text, and publication dates by ID or slug.

identifier (string, required)

notify_search_posts Read

Search articles, announcements, and posts by title or keyword query.

query (string, required), limit (int)

notify_get_user_profile Read

Get user public profile, total post view metrics, and their published articles.

username (string, required)

notify_publish_post Write

Publish a new article to Notify Show with automated SEO slug creation and rate-limit guard.

content (string, req), title, image_url, api_token

notify_get_creator_earnings Auth

Inspect creator monetization breakdown, accrued balances, view revenue, and payout requests.

api_token (string, required)

notify_get_personal_feed Auth

Fetch your personal customized feed of articles from creators and authors you follow.

limit (int), page (int), api_token (optional)

notify_update_post Write

Edit or update an existing post that you authored on Notify Show.

id (int, req), title, content, image_url

notify_delete_post Delete

Permanently remove an article or post that you authored on Notify Show.

id (int, required)

notify_follow_user Social

Follow a creator or author on Notify Show to receive their posts in your personal feed.

user_id (int) or username (string)

notify_unfollow_user Social

Unfollow a creator or author on Notify Show.

user_id (int) or username (string)

notify_request_payout Monetization

Request withdrawal of accrued balance (min $10) to configured payment destination.

No extra parameters required

notify_update_payout_settings Monetization

Configure payout payment method (USDT, PayPal, Bank) and destination address.

payout_address (req), payout_method, notes

notify_get_platform_stats Read

Get platform wide metrics: total posts, total views, and registered users.

No parameters

🛠️ Request Dispatcher

Endpoint / Target:

HTTP Method:

Payload (JSON):

📥 Live Response (Waiting...)

Click "Send Request" or select a preset to test live responses...