The latest articles on DEV Community by XYG-LUNA (@xygluna). https://dev.to/xygluna https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4028240%2Fd04eb61b-59a7-4dd6-bb53-4ec8f3b423a8.png https://dev.to/xygluna en XYG-LUNA Tue, 14 Jul 2026 07:15:05 +0000 https://dev.to/xygluna/building-a-payment-enabled-mcp-server-let-ai-agents-pay-for-skills-via-http-402-2ao5 https://dev.to/xygluna/building-a-payment-enabled-mcp-server-let-ai-agents-pay-for-skills-via-http-402-2ao5 <h1> Building a Payment-Enabled MCP Server: Let AI Agents Pay for Skills via HTTP 402 </h1> <h2> The Problem </h2> <p>In the traditional SaaS model, users need to sign up, subscribe, and bind a credit card before they can use an AI tool. This creates high friction.</p> <p>The answer is <strong>HTTP 402 Payment Required</strong> — a rarely-used HTTP status code perfect for pay-per-use AI APIs.</p> <h2> What is HTTP 402? </h2> <p>HTTP 402 "Payment Required" is a standard HTTP status code. When a client calls an API without payment, the server returns 402 with payment parameters. After payment, the request is processed.</p> <h2> The Architecture </h2> <p>I built this for <strong>CHROMATIC-MCP</strong> — an MCP Server exposing 252 AI skills through 12 MCP tools:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight plaintext"><code>Client → API Gateway (Auth + Payment Check) → Skill Router → Skill Server </code></pre> </div> <h3> Key Components </h3> <ol> <li> <strong>Free Tier</strong>: 10 free calls per skill per day, no auth needed</li> <li> <strong>Alipay AI Pay</strong>: Auto-debit agreement for seamless payments</li> <li> <strong>MCP Tools</strong>: Each skill registered as individual MCP tool</li> </ol> <h2> 12 MCP Tools </h2> <div class="table-wrapper-paragraph"><table> <thead> <tr> <th>Tool</th> <th>Price</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>discover_skills</td> <td>Free</td> <td>Browse all 252 skills</td> </tr> <tr> <td>skill_mbti-deep-analysis</td> <td>¥0.10</td> <td>MBTI assessment</td> </tr> <tr> <td>skill_bianzhen</td> <td>¥0.50</td> <td>Multi-model fact-checking</td> </tr> <tr> <td>skill_ad-copywriter</td> <td>¥0.10</td> <td>Ad copy generation</td> </tr> <tr> <td>skill_zhuojian</td> <td>¥0.50</td> <td>5-layer deep analysis</td> </tr> <tr> <td>skill_cuilu</td> <td>¥0.50</td> <td>Skill forging engine</td> </tr> <tr> <td>skill_weekly-report</td> <td>¥0.10</td> <td>Weekly report generator</td> </tr> <tr> <td>skill_taobao-listing</td> <td>¥0.10</td> <td>E-commerce copywriting</td> </tr> <tr> <td>skill_contract-guardian</td> <td>¥0.10</td> <td>AI contract review</td> </tr> <tr> <td>skill_game-audio</td> <td>¥0.10</td> <td>Game audio design</td> </tr> <tr> <td>skill_shijin</td> <td>¥0.50</td> <td>Skill quality testing</td> </tr> <tr> <td>get_skill_detail</td> <td>Free</td> <td>Get skill details</td> </tr> </tbody> </table></div> <h2> Quick Start </h2> <h3> Install via npx </h3> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>npx <span class="nt">-y</span> chromatic-mcp-skills@latest </code></pre> </div> <h3> Configure in Claude Desktop / Cursor </h3> <div class="highlight js-code-highlight"> <pre class="highlight json"><code><span class="p">{</span><span class="w"> </span><span class="nl">"mcpServers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"CHROMATIC-MCP"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"command"</span><span class="p">:</span><span class="w"> </span><span class="s2">"npx"</span><span class="p">,</span><span class="w"> </span><span class="nl">"args"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"-y"</span><span class="p">,</span><span class="w"> </span><span class="s2">"chromatic-mcp-skills@latest"</span><span class="p">]</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="p">}</span><span class="w"> </span></code></pre> </div> <h3> Try a Skill (Free) </h3> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>curl http://124.222.26.218:3000/api/skill/mbti-deep-analysis </code></pre> </div> <h2> Why HTTP 402 Works for AI </h2> <ol> <li> <strong>Zero friction</strong>: No signup, no credit card. First 10 calls free.</li> <li> <strong>Standard protocol</strong>: Any HTTP client understands 402.</li> <li> <strong>Agent-friendly</strong>: AI agents can detect 402 and handle payment.</li> <li> <strong>Granular pricing</strong>: ¥0.10–¥0.50 per call depending on complexity.</li> </ol> <h2> Lessons Learned </h2> <ul> <li>402 is underutilized but semantically correct for payment walls</li> <li>Free tier removes all friction for evaluation</li> <li>Alipay AI Pay auto-debit means returning users never see payment prompts</li> <li>MCP is the future — any AI agent can discover and use skills</li> </ul> <h2> What's Next </h2> <ul> <li>Multi-model support</li> <li>Volume discounts</li> <li>Third-party skill submissions</li> <li>More payment methods</li> </ul> <p><strong>GitHub</strong>: <a href="https://github.com/Chromatic0618/alipay-mcp-server" rel="noopener noreferrer">https://github.com/Chromatic0618/alipay-mcp-server</a><br> <strong>npm</strong>: <code>chromatic-mcp-skills</code><br> <strong>Live API</strong>: <a href="http://124.222.26.218:3000/api/skills" rel="noopener noreferrer">http://124.222.26.218:3000/api/skills</a></p> <p><em>Built by Chromatic0618. MIT License.</em></p> agents ai api mcp