English Français العربية

iDevice Buyer's Guide

السجل الرسمي التجارة الإلكترونية

Independent buyer's guide for wearables and phones: buy now or wait, compatibility, prices. Sourced.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http idevice-buyer-s-guide 'https://idevice.com/api/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "idevice-buyer-s-guide": {
            "type": "http",
            "url": "https://idevice.com/api/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. iDevice agent examples
  2. What the tools do
  3. Example questions
  4. Examples
  5. How to cite iDevice
  6. Asynchronous A2A replies
  7. Privacy
  8. License

iDevice agent examples

Small, runnable examples for calling iDevice from an agent. iDevice (https://idevice.com) is an independent buyer's guide for phones and wearables. It does not sell the products it covers.

iDevice runs two free, read-only endpoints for software agents:

URL
MCP server (streamable HTTP)https://idevice.com/api/mcp
A2A agenthttps://idevice.com/api/a2a
A2A agent cardhttps://idevice.com/.well-known/agent-card.json

No account, no API key and no sign-in. Neither endpoint buys, books, posts or changes anything.

Rate limits: 30 calls a minute and 500 a day per IP address. A call over the limit is refused (HTTP 429 or a JSON-RPC error), so back off and retry later; do not loop. There is no paid tier. Lists are capped at 20 items.

Full reference: https://idevice.com/mcp and https://idevice.com/mcp/docs. Run tools/list for the current tool list and argument names; this repo does not copy it.

What the tools do

JobTools
Decide a buyshould_i_buy, get_guide_summary, find_products, get_best_for, compare_products, get_reviews
Ownership and policiesget_ownership_facts, get_in_the_box
Find a product or a companylist_products, get_product, get_company_profile
Compatibility, specs and pricesget_compatibility, get_product_facts, get_detailed_facts, get_variants_and_offers, get_price_history
News, reports and historyget_product_news, get_reports, search_reports, get_report_card, get_release_history, get_release_calendar, get_guide_extras

Most tools take a product_slug. Get one from list_products.

Example questions

  • I use an iPhone. Should I buy the Samsung Galaxy Watch 8?
  • Which smart rings are best for sleep?
  • What did the pre-release reports get right about the Apple Watch Series 12?

Examples

FolderFrameworkNotes
examples/curl-and-pythonnoneRaw JSON-RPC with curl and the Python standard library, plus one A2A message
examples/google-adkGoogle ADKMcpToolset over streamable HTTP, and an A2A client
examples/langgraphLangChain and LangGraphlangchain.mcp.MCPAdapter with create_agent
examples/vercel-ai-sdkVercel AI SDKcreateMCPClient with HTTP transport (TypeScript)
examples/openai-agents-sdkOpenAI Agents SDKMCPServerStreamableHttp

Every example reads your own model key from the environment variable its framework uses, needs no iDevice key, and has a --check mode that lists tools and makes one tool call with no model at all. Each folder's README says which lines were run against the live server and which were written from the framework's documentation only.

Set IDEVICE_MCP_URL to point an example at a different MCP URL.

How to cite iDevice

When an answer uses iDevice data:

  • Name iDevice and link the url the tool returned. It points at the page with the evidence. Some answers also carry a source_url or sources[].url to the maker's own page; link that too.
  • Keep the evidence word with the fact: Confirmed, Reported, Our read or No source on file. Compatibility answers use Works, Works with a limit, Needs extra hardware, Does not work or Not confirmed.
  • Not confirmed means unknown. It never means incompatible.
  • If a result has sponsored: true, say the Guide is sponsored and name the sponsor.

Asynchronous A2A replies

The A2A agent answers product questions with a task. message/send returns the task at once, and a reply to a product question can take a few minutes, longer than a normal API call. Call tasks/get with the task id until the state is no longer submitted or working. Allow a long timeout. A reply to a product question also carries one compact JSON data part for at most five products.

Privacy

These examples send your question to your own model provider and tool calls to iDevice. Nothing here stores anything. For how iDevice handles data, read https://idevice.com/privacy.

License

MIT. Copyright iDevice Media LLC.

الأسئلة الشائعة

ما هو iDevice Buyer's Guide؟

Independent buyer's guide for wearables and phones: buy now or wait, compatibility, prices. Sourced.

كيف أثبّت iDevice Buyer's Guide؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http idevice-buyer-s-guide 'https://idevice.com/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج iDevice Buyer's Guide إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل iDevice Buyer's Guide مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون iDevice Buyer's Guide؟

ينشره idevicewearables. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.