↑↓ تنقّل ↵ فتح esc إغلاق
SELL TO STATE.
ابدأ الآن
MCP عبر HTTP · 26 أداة

بيانات مشتريات يستطيع وكيلك استخدامها بنفسه.

Point any MCP-capable client — Claude Desktop, Claude Code, Cursor, or your own agent — at our streamable-HTTP endpoint. It can search government tenders and contract awards from official sources, drill into buyers and suppliers, keep lists, and even self-register and pay for access with no human in the loop.

Tool reference → REST API

# نقطة النهاية

https://app.selltostate.com/api/mcp

# عرض قائمة الأدوات (مفتوحة، بلا مصادقة)

curl -s https://app.selltostate.com/api/mcp \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,
       "method":"tools/list"}'

tools/list is open; tools/call resolves your credential and 402s if un-entitled.

Add it to your client.

Clients with a browser sign you in with OAuth. Other clients send an API key from your account. The server is in the official MCP Registry as com.selltostate/mcp.

Claude

Customize, then Connectors. Select + Add, then Add custom connector. Paste the URL and select Connect.

https://app.selltostate.com/api/mcp
Step by step →

ChatGPT

On chatgpt.com/plugins, select + and Add custom MCP server. Paste the URL and choose OAuth.

https://app.selltostate.com/api/mcp
Step by step →

Claude Code

Add the server, then run /mcp and choose Authenticate.

claude mcp add --transport http selltostate https://app.selltostate.com/api/mcp
Step by step →

Gemini CLI

Install the extension. Gemini CLI opens your browser to sign in.

gemini extensions install https://github.com/getbeton/selltostate-skills
Step by step →

Cursor and other clients

Add the server to mcp.json with your API key in the x-api-key header.

{
  "mcpServers": {
    "selltostate": {
      "url": "https://app.selltostate.com/api/mcp",
      "headers": { "x-api-key": "sts_..." }
    }
  }
}

مسار الاتصال.

  1. 1

    الاكتشاف

    تقرأ العملاء المتوافقة مع المواصفة الملف /.well-known/oauth-protected-resource (RFC 9728) والملف /.well-known/oauth-authorization-server (RFC 8414) لمعرفة المورد والجهة المُصدرة والنطاقات.

  2. 2

    التسجيل

    بلا اعتماد مُشترك مسبقًا، يسجّل العميل نفسه ذاتيًا عبر RFC 7591 DCR (POST /api/oidc/register) ليحصل على client_id بلا أي نطاقات بيانات، إضافة إلى payment_link.

  3. 3

    Authenticate

    Clients with a browser (Claude, ChatGPT, Cursor) run the OAuth 2.1 authorization-code flow with PKCE, and you sign in with your Sell to State account. An agent without a browser presents the issued client as Authorization: Bearer client:<client_id> on every tools/call.

  4. 4

    الاشتراك

    إلى أن يُمنح صاحب العميل الحق، يعيد كل tools/call نفس جسم الاستجابة 402 الذي تعيده REST — رابط payment_link موجّه للبشر وإمكانية machine_payment الأصلية للوكلاء. يستدعي الوكيل pay، فيُخصم منه خارج الجلسة (off-session)، وتعيد استدعاءه التالي البيانات.

26 أداة، بتكافؤ كامل مع REST.

Every tool mirrors a REST endpoint 1:1. Owner-scoped list / saved-search tools require a user API key; an OIDC client token gets a requires_user_key result. Full schemas in the reference.

whoami data:read الهوية + الاستحقاق + النطاقات (غير مقيدة — تحقق قبل أن تنفق).
search data:read بحث متعدد الأوجه ضمن نطاق واحد: tenders | buyers | suppliers | sectors.
search_awards data:read مستكشف العقود الممنوحة (q، الجهة، المورّد، الفئة، السنة، نطاق القيمة).
get_buyer data:read تفاصيل الجهة الحكومية (get_buyer_detail اسم بديل محتفَظ به).
get_supplier_detail data:read تفاصيل المورّد مع أبرز الجهات الحكومية وتوزيع القطاعات.
get_sector / get_tender data:read ملف القطاع · عقد ممنوح واحد + العقود ذات الصلة.
list_buyers / list_suppliers / list_sectors data:read أفضل N من الجهات الحكومية والموردين وتصنيف القطاعات.
get_lists / create_list / add_to_list … data:read عمليات CRUD على قوائم العقود المحفوظة — تتطلب مفتاح API الخاص بالمستخدم.
get_saved_searches / save_search … data:read عمليات CRUD على عمليات البحث المحفوظة — تتطلب مفتاح API الخاص بالمستخدم.
export data:export تصدير مجموعة عقود مُصفّاة كملف CSV.
pay billing:pay ادفع تلقائيًا برمز Stripe لفتح الوصول — بلا صفحة دفع.

استدعِ أداة.

curl -s https://app.selltostate.com/api/mcp \
  -H "Authorization: Bearer client:c_abc123" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"search",
                 "arguments":{"scope":"tenders","q":"cloud","year_min":2024}}}'

بمجرد الاتصال، فقط اسأل

  • → «ابحث في Sell to State عن عقود الأمن السيبراني الممنوحة في 2024، ولخّص أفضل 5 موردين.»
  • → «اجلب كل عقد منحته وزارة التعليم هذا العام، وصدّره كملف CSV.»
  • → «استخدم get_buyer على الجهة المعنية — ممن تشتري سنغافورة خدمات البناء؟»

اربط وكيلك.

Create an account, generate an API key, and point your MCP client at https://app.selltostate.com/api/mcp. Agents can also self-register and pay without a dashboard. Full tool docs at docs.selltostate.com.

Start for free →
اشترك