Api.Airforce
MCP सर्वर

MCP सर्वर

किसी भी Model Context Protocol क्लाइंट को Api.Airforce से जोड़ें — हमारे मॉडल, इमेज, मॉडल सूची और अपना बैलेंस MCP टूल्स के रूप में उपयोग करें, शुल्क आपके अकाउंट से लिया जाता है।

MCP क्या है?

Model Context Protocol (MCP) AI एजेंट क्लाइंट्स — जैसे Claude Desktop, Cursor या किसी भी MCP-सक्षम ऐप — को बाहरी सेवाओं को टूल के रूप में कॉल करने देता है। Api.Airforce एक रिमोट MCP सर्वर चलाता है ताकि ये क्लाइंट हमारे मॉडल सीधे उपयोग कर सकें।

एंडपॉइंट और ट्रांसपोर्ट

सर्वर एक ही एंडपॉइंट पर Streamable HTTP के ऊपर JSON-RPC 2.0 बोलता है, प्रोटोकॉल संस्करण 2025-06-18। जब आप Accept: text/event-stream हेडर भेजते हैं तो स्ट्रीमिंग प्रतिक्रियाएँ लौटाई जाती हैं।

POST https://api.airforce/mcp

प्रमाणीकरण

अपनी Api.Airforce API कुंजी — या एक OAuth 2.0 bearer टोकन — Authorization हेडर में भेजें। अप्रमाणित अनुरोध 401 लौटाते हैं और साथ में एक WWW-Authenticate चैलेंज होता है जो हमारे OAuth मेटाडेटा की ओर इशारा करता है, ताकि संगत क्लाइंट OAuth फ़्लो स्वतः शुरू कर सकें।

OAuth टोकन के लिए संबंधित scope हैं profile (get_balance के लिए), chat (chat_completion के लिए) और images (generate_image के लिए)।

क्लाइंट जोड़ना

अधिकांश क्लाइंट एक रिमोट MCP सर्वर URL और एक bearer टोकन स्वीकार करते हैं। एक सामान्य कॉन्फ़िगरेशन ऐसा दिखता है:

{
  "mcpServers": {
    "api-airforce": {
      "url": "https://api.airforce/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

आप JSON-RPC initialize कॉल से कनेक्शन को मैन्युअल रूप से सत्यापित कर सकते हैं:

curl -X POST https://api.airforce/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0.0"}}}'

उपलब्ध टूल

रनटाइम पर इन्हें खोजने के लिए tools/list कॉल करें। चार टूल उपलब्ध हैं:

list_models

कीमतों और क्षमता फ़्लैग के साथ उपलब्ध मॉडलों की सूची देता है।

get_balance

आपका pay-as-you-go बैलेंस (US सेंट में) और मौजूदा प्लान लौटाता है। OAuth टोकन के लिए profile scope आवश्यक है।

chat_completion

OpenAI-संगत chat completion चलाता है। बिल्कुल POST /v1/chat/completions की तरह आपके अकाउंट से शुल्क लिया जाता है।

generate_image

एक इमेज बनाता है। बिल्कुल POST /v1/images/generations की तरह आपके अकाउंट से शुल्क लिया जाता है।

curl -X POST https://api.airforce/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

बिलिंग

chat_completion और generate_image आपके अकाउंट से REST API के समान दरों पर बिल किए जाते हैं — कोई अलग MCP मूल्य नहीं है। list_models और get_balance मुफ़्त हैं।

डिस्कवरी

स्वचालित खोज के लिए एक मशीन-पठनीय सर्वर कार्ड प्रकाशित किया जाता है:

https://api.airforce/.well-known/mcp/server-card.json