Skip to main content
I think your developer’s content is excellent, but it reads like technical documentation from an engineer. I’d turn it into product documentation like Stripe, Anthropic, Vercel and GitHub. The biggest difference isn’t the writing—it’s the components.

​
Why competitors’ docs look better

For example, this: 
{
  "mcpServers": {
    ...
  }
}
looks like an actual IDE because they’re using code fences with syntax highlighting. In Mintlify you simply write: 
```json
{
  "mcpServers": {
    "serptag": {
      "url": "https://mcp.serptag.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```
Mintlify automatically renders it like VS Code with:
  • ✅ colours
  • ✅ copy button
  • ✅ JSON highlighting
  • ✅ dark mode
  • ✅ line spacing
No extra work.

​
Then use Cards

Instead of 
Cursor
Claude
VS Code
Windsurf
Use cards. 
Cursor
⭐ Recommended

Connect using Remote HTTP.

→ Setup Cursor

Claude Desktop

Connect using npm.

→ Setup Claude

VS Code

Connect using npm.

→ Setup VS Code

Windsurf

Connect using HTTP.

→ Setup Windsurf
It immediately looks modern.

​
Use Callouts

Instead of
Requires Agency plan
Make it a coloured callout. 🟦 Info Requires an Agency or Enterprise subscription.
🟨 Tip Use Cursor if you’re new to MCP. It supports direct HTTP and only takes a minute to configure.
🟥 Warning Never share your API key.

​
Use Steps

Instead of 
Step 1

Step 2

Step 3
Mintlify has beautiful numbered sections. Example

​
Step 1

Generate an API key. ↓ Screenshot ↓ Copy the key.

​
Step 2

Open Cursor. ↓ Paste the config. ↓ Restart Cursor.

​
Add screenshots

I’d have screenshots for every page. For example Quick Start ↓ Screenshot of Dashboard ↓ Screenshot of API Keys ↓ Screenshot of Cursor config ↓ Screenshot of Cursor connected People LOVE screenshots.

​
Tabs

Instead of one massive page Use tabs. Like this 
Cursor | Claude | VS Code | Windsurf
When you click Cursor it shows 
...
Click Claude Different config. Click VS Code Different config. Exactly like Stripe.

​
Code Groups

Instead of scrolling 
Cursor

JSON

Claude

JSON

VS Code

JSON
Make them tabs.

​
Timeline

Instead of paragraphs 
Dashboard

↓

API Key

↓

Cursor

↓

Ask AI

↓

Done
Looks much easier.

​
Next Steps cards

Instead of 
What's next

Create API Key

Install MCP
Have four nice cards. 
🔑

Create API Key

Learn more →

🤖

Install MCP

Learn more →

💬

First Prompt

Learn more →

🛠

Available Tools

Learn more →

​
Search tip

At the top of every page 
Estimated time

⏱ 5 minutes

Difficulty

⭐ Beginner

Requirements

Agency Plan
People love this.

​
What I would build

Instead of making pages that look like documentation… I’d make them look like a product. Very similar to
  • Stripe
  • OpenAI
  • Anthropic
  • Vercel
  • Supabase
because Mintlify already supports nearly all these components.

​
My suggestion

Rather than just giving you text to paste, I’d help you build one page at a time using Mintlify’s components—cards, tabs, callouts, steps, code blocks, screenshots, accordions, and copy buttons. The result will feel like documentation from a company with a dedicated developer experience team, not just a collection of text pages. I think that’s exactly the impression SERPtag should give.