# FineProxy Agent Pack

संस्करण: 2026-09-22

इस फ़ाइल का उपयोग यह आकलन करने के लिए करें कि क्या किसी मौजूदा प्रॉक्सी इंटीग्रेशन को FineProxy पर माइग्रेट किया जा सकता है। इसमें कोई API कुंजी, अकाउंट डेटा या निजी एंडपॉइंट नहीं है।

## सत्य के स्रोत

- इंटरैक्टिव क्लाइंट API दस्तावेज़: `https://fineproxy.org/account_new/docs`
- MCP सेटअप: `https://fineproxy.org/account_new/mcp`
- वर्तमान क्लाइंट OpenAPI स्पेसिफिकेशन: इसे ग्राहक डैशबोर्ड में API दस्तावेज़ से डाउनलोड करें।
- API कुंजियाँ बनाएँ और प्रबंधित करें: `https://fineproxy.org/account_new/settings`
- MCP एंडपॉइंट: `https://fineproxy.org/account_new/api/v1/mcp`

इस अवलोकन के आधार पर कभी कोई एंडपॉइंट न गढ़ें। अनुरोध पथ, स्कीमा, पैरामीटर और प्रतिक्रियाओं के लिए वर्तमान OpenAPI स्पेसिफिकेशन उपयोग करें।

## प्लेटफ़ॉर्म सारांश

- REST API: OpenAPI 3.1, ग्राहक के लिए दस्तावेज़ीकृत 49 ऑपरेशन।
- MCP: stateless JSON-RPC 2.0 और Streamable HTTP पर 49 टूल।
- प्रमाणीकरण: ग्राहक डैशबोर्ड में बनाई गई bearer API कुंजियाँ।
- API और MCP समान दायरा-आधारित अनुमतियाँ उपयोग करते हैं।
- पार्टनर API दस्तावेज़ केवल सक्रिय पार्टनर स्थिति वाले अकाउंट को दिखाई देते हैं।

## समर्थित वर्कफ़्लो

### खरीद और प्रोविज़निंग

- देशों और लाइव IP इन्वेंटरी की सूची देखें।
- खरीदारी किए बिना कई देशों के सटीक पैकेज का कोटेशन पाएँ।
- कीमत सुरक्षा और idempotency कुंजी के साथ डैशबोर्ड वॉलेट से खरीदें।

मानक MCP खरीद क्रम है:

1. `list_countries`
2. `quote_composite`
3. `order_composite`

### सेवा प्रबंधन

- सेवाएँ पढ़ें और प्रबंधित करें।
- समर्थित होने पर नवीनीकरण, निलंबन, पुनर्स्थापन या रद्दीकरण करें।
- ऑटो-रिन्यूअल चालू या बंद करें।
- IP एड्रेस बदलें या जोड़ें।
- सेवा क्रेडेंशियल बदलें।
- अनुमति-सूची की सीमाएँ पढ़ें और प्रबंधित करें।
- संगत ऐड-ऑन की सूची देखें, खरीदें और रद्द करें।

### एनालिटिक्स और निदान

- उपयोग का अवलोकन और समय-श्रृंखला।
- प्रमुख गंतव्य।
- एरर श्रेणियाँ।
- परिचालन सुझाव।

### बिलिंग और सहायता

- इनवॉइस पढ़ें और इनवॉइस PDF डाउनलोड करें।
- भुगतान गेटवे की सूची देखें।
- वॉलेट जमा शुरू करें और उसकी स्थिति पढ़ें।
- सहायता टिकट बनाएँ, पढ़ें, जवाब दें और बंद करें।

### प्रॉक्सी एक्सेस और अकाउंट

- रोटेटिंग-प्रॉक्सी कनेक्शन कॉन्फ़िगरेशन पढ़ें।
- सेवा लॉगिन और पासवर्ड बदलें।
- अनुमति-सूची में प्रति-IP कनेक्शन सीमाएँ प्रबंधित करें।
- प्रोफ़ाइल जानकारी, कॉलर IP और लॉगिन इतिहास पढ़ें।
- वेबहुक कॉन्फ़िगर करें।

## अनुमति दायरे

- `customer:read` — ग्राहक और अकाउंट की जानकारी पढ़ें।
- `customer:write` — ग्राहक की जानकारी अपडेट करें।
- `wallet:read` — वॉलेट की जानकारी पढ़ें।
- `wallet:deposit` — जमा बनाएँ और निगरानी करें।
- `wallet:spend` — वॉलेट की राशि खर्च करें। इसे वित्तीय अनुमति मानें।
- `services:read` — सेवाएँ और प्रॉक्सी सेटिंग पढ़ें।
- `services:write` — सेवाएँ और ऐड-ऑन बनाएँ या बदलें।
- `tickets:read` — सहायता टिकट पढ़ें।
- `tickets:write` — टिकट बनाएँ, जवाब दें, अपडेट करें या बंद करें।
- `catalog:read` — उत्पाद, विकल्प, देश और स्टॉक पढ़ें।
- `usage:read` — उपयोग और निदान पढ़ें।
- `webhooks` — वेबहुक सदस्यताएँ प्रबंधित करें।

माइग्रेशन ऑडिट केवल-पढ़ने की अनुमतियों से शुरू करें। प्रस्तावित बदलावों की समीक्षा के बाद ही लेखन या वित्तीय अनुमतियाँ जोड़ें।

## सुरक्षा व्यवहार

- वित्तीय टूल के लिए `wallet:spend` आवश्यक है।
- खरीद में कोटेशन का अपेक्षित कुल शामिल होता है। कीमत मेल न खाने पर ऑपरेशन अस्वीकार हो जाता है।
- अपरिवर्तनीय ऑपरेशन के लिए स्पष्ट पुष्टि आवश्यक है।
- वित्तीय पुनः प्रयास idempotency कुंजी उपयोग करते हैं, ताकि एक ही ऑपरेशन के लिए दो बार शुल्क न लगे।
- लाइव इन्वेंटरी, प्लान पात्रता और अकाउंट अनुमतियाँ किसी अन्यथा मान्य ऑपरेशन को रोक सकती हैं।
- FineProxy MCP ग्राहक अकाउंट संचालित करता है। जब तक उपयोगकर्ता कोडिंग एजेंट को अलग से किसी रिपॉज़िटरी का एक्सेस न दे, इसे स्रोत कोड का एक्सेस नहीं मिलता।

## MCP कॉन्फ़िगरेशन टेम्पलेट

```json
{
  "mcpServers": {
    "fineproxy": {
      "url": "https://fineproxy.org/account_new/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer fb_YOUR_API_KEY"
      }
    }
  }
}
```

वास्तविक कुंजी को एनवायरनमेंट वेरिएबल या सीक्रेट मैनेजर में रखें। इसे MCP कॉन्फ़िगरेशन के साथ कमिट न करें।

## माइग्रेशन संगतता चेकलिस्ट

मौजूदा इंटीग्रेशन में इनकी जाँच करें:

1. प्रोवाइडर क्लाइंट इनिशियलाइज़ेशन और सभी प्रोवाइडर-विशिष्ट इम्पोर्ट।
2. प्रमाणीकरण हेडर, क्रेडेंशियल, एनवायरनमेंट वेरिएबल और सीक्रेट संग्रहण।
3. खरीद, नवीनीकरण, रद्दीकरण और IP प्रतिस्थापन वर्कफ़्लो।
4. देश पहचानकर्ता और इन्वेंटरी संबंधी मान्यताएँ।
5. प्रॉक्सी सूची फ़ॉर्मेट, प्रोटोकॉल, पोर्ट, उपयोगकर्ता नाम, पासवर्ड और IP अनुमति-सूची।
6. पेजिनेशन और फ़िल्टरिंग।
7. पुनः प्रयास व्यवहार, टाइमआउट प्रबंधन और idempotency।
8. एरर मॉडल और रेट प्रबंधन।
9. उपयोग एनालिटिक्स और निदान।
10. बिलिंग, इनवॉइस और जमा।
11. सहायता-टिकट इंटीग्रेशन।
12. वेबहुक और इवेंट पेलोड संबंधी मान्यताएँ।
13. वर्तमान प्रोवाइडर से जुड़े परीक्षण, फ़िक्स्चर, मॉक और CI सीक्रेट।

हर वर्कफ़्लो को इस प्रकार वर्गीकृत करें:

- बिना बदलाव के संगत।
- कॉन्फ़िगरेशन बदलाव से संगत।
- अडैप्टर या डेटा रूपांतरण आवश्यक।
- अलग परिचालन वर्कफ़्लो आवश्यक।
- वर्तमान दस्तावेज़ से असमर्थित या अपुष्ट।

## आवश्यक ऑडिट आउटपुट

ऑडिट में ये शामिल होने चाहिए:

1. वर्तमान प्रोवाइडर की हर निर्भरता की सूची।
2. प्रत्येक वर्कफ़्लो का संगतता आकलन।
3. आवश्यक FineProxy दायरे।
4. बदलने वाली सटीक फ़ाइलें और कोड पथ।
5. प्रमाणीकरण और सीक्रेट प्रबंधन में बदलाव।
6. खुले प्रश्न जिनके लिए वर्तमान OpenAPI स्पेसिफिकेशन या सहायता से पुष्टि आवश्यक है।
7. रोलबैक सहित चरणबद्ध माइग्रेशन योजना।
8. कटओवर से पहले आवश्यक इंटीग्रेशन परीक्षण।

पहले ऑडिट चरण में कोड में बदलाव न करें।