mctxdocs
Promote your server

Your Vanity Link

Every mctx server gets a custom vanity link. Use it everywhere you promote your server.

Need help? Connect help.mctx.ai for instant answers.

Every mctx server gets its own URL:

https://your-slug.mctx.ai

This is your server's home on the web. It is the link you share on Twitter, drop in your README, post on Discord, and include in blog posts. When someone visits, they see everything they need to subscribe and start using your server.

What visitors see

Your vanity link page displays:

  • Server name and description
  • Author identity (linked to the GitHub repository owner's profile)
  • Current pricing (per 1,000 requests)
  • Available versions
  • One-click subscribe button
  • Installation instructions (shown after subscribing)

All of this updates automatically as you deploy new versions and adjust your settings. No manual page management required.

Why this matters

Your vanity link is the single best URL to share when promoting your server.

It is short and memorable. weather-api.mctx.ai sticks in someone's head. A GitHub repo URL does not.

It converts. Visitors can subscribe with one click. No hunting for install instructions or pricing details.

It stays current. Push a new version, change your description, adjust pricing -- the page reflects it automatically.

It is always the right link. Instead of sending people to a GitHub repo, a docs site, or a registry listing, send them here. Everything they need is in one place.

Where to use it

Social media

Twitter/X:

Just launched Weather API on mctx.

Real-time weather data for any AI assistant.

Try it: https://weather-api.mctx.ai

#MCP #AI

Discord:

Hey all! Built an App for real-time weather data.

Check it out: https://weather-api.mctx.ai

Happy to answer questions!

Reddit:

I built Weather API to solve the problem of getting
live weather into AI workflows.

You can try it here: https://weather-api.mctx.ai

Your GitHub README

Add a quick link so anyone browsing your repo can find the hosted version:

## Try It

Subscribe at [weather-api.mctx.ai](https://weather-api.mctx.ai)

Or use a badge:

[![Subscribe on mctx](https://img.shields.io/badge/Subscribe-mctx-blue)](https://weather-api.mctx.ai)

Directory submissions

When submitting to awesome-mcp-servers, MCP.so, or similar directories, use your vanity link as the primary URL:

- [Weather API](https://weather-api.mctx.ai) - Real-time weather data for AI assistants

Blog posts and content

You can try [Weather API](https://weather-api.mctx.ai) with a one-click subscribe.

Email signature

---
Built Weather API: https://weather-api.mctx.ai

How the redirect works

When someone visits https://your-slug.mctx.ai/ in their browser, they get redirected to the full info page at https://mctx.ai/apps/your-slug. This keeps your shareable link short while giving visitors a full-featured landing page.

Always share the short version. It is easier to remember and type.

Version-specific pages

You can also link to a specific version of your server:

https://your-slug.mctx.ai/v1.0.0

This shows details for that exact version, including what changed and how to install it.

When version-specific links are useful:

  • Announcing a major new release
  • Pointing someone to docs for a particular version
  • Helping a subscriber troubleshoot a version-specific issue

Most of the time, use the base link (your-slug.mctx.ai). It always shows the latest info, and subscribers can pick their version after subscribing.

Customize what people see

Your vanity link page pulls its content from your package.json:

{
  "name": "weather-api",
  "version": "1.0.0",
  "description": "Real-time weather data for any AI assistant"
}

Name -- Keep it clear and descriptive. This is the headline people see.

Description -- One sentence that explains the value of your server. Think of it as your elevator pitch. For tips, see Writing Effective Descriptions.

Version -- Uses semantic versioning (major.minor.patch).

Changes show up on the next deployment. Update your package.json, push a new version, and the page refreshes automatically.

Tips from developers who have done this

Keep your slug short. weather is better than weather-api-v2-production. Shorter slugs are easier to share, easier to type, and easier to remember.

Do not change your slug. It is permanent. Changing it would break every link you have shared. Pick a good one from the start.

Use your vanity link as your primary URL everywhere. Not your GitHub repo, not a blog post, not a docs page. Your vanity link is the single place where visitors can learn about your server and subscribe immediately.

Update your description as your server evolves. When you add new capabilities, make sure your package.json description reflects them. This is what people see before deciding to subscribe.

Next Steps


See something wrong? Report it or suggest an improvement — your feedback helps make these docs better.