NAIF Gravity — MCP Diagnostics & Recovery README

NAIF Gravity — MCP & Integration Diagnostics

Explore our products — free first

All product links, problem-to-product guide and limits → · أدلة مجانية بالعربية

New look at NAIF Gravity — 30 October 2026

The NAIF Gravity storefront has a refreshed visual identity: midnight navy, copper accents and a glass-inspired homepage experience, with Arabic and English controls. Explore the updated storefront and service catalog.

مظهر جديد لمتجر NAIF Gravity: هوية كحلية ونحاسية وتجربة زجاجية في الصفحة الرئيسية، مع خيارات العربية والإنجليزية. شاهد المتجر.

This announcement covers the storefront design. Service scope, availability and current prices are stated on the relevant live service pages; the redesign does not establish new product readiness.

NAIF Gravity provides bounded diagnostics and repair workflows for MCP, AI-agent integrations, APIs, authentication, and webhooks, with reproducible developer-facing diagnostics and machine-readable agent discovery.

Start with the Diagnostic Hub or visit NAIF Gravity.

New — GitHub Issue Radar (14 Oct 2026): Read source-linked MCP and x402 failure diagnoses, proposed fixes, and regression checks. Public technical notes only; no third-party patches or paid transactions were performed.

This repository contains public diagnostic guidance, a small Python MCP health-check script, issue templates, and discovery metadata. It is not a complete source distribution of the hosted service.

Micro Tools V2 — free previews, separate live service pages

Malformed JSON? Unexpected API response? Inconsistent CSV? Start with a bounded free preview. The preview does not charge, create an order, or deliver a paid report. The separate Micro V2 paid-report checkout is not currently active.

For an optional, separately scoped one-time service, check the live page rather than assuming a Micro V2 preview can be upgraded in place:

Current price, regional eligibility, payment options and delivery terms are only those shown by each live service page and accepted quote. Inputs must be sanitized; do not submit API keys, customer records, payment credentials or private keys. The per-call x402 API routes below are separate from both the free preview and individual checkout.

Install NAIF JSON Rescue for your agent

NAIF JSON Rescue checks a sanitized JSON sample locally before any external call. The free Node.js checker does not upload data, modify files or spend funds. Optional hosted diagnostics provide the existing bounded JSON artifact through x402 on Base, only within the buyer's disclosure permission and payment budget. A valid syntax-only sample needs no paid call.

With the Skills CLI, review and install just this skill:

npx skills add naief9961-tech/ai-growth-engine --skill naif-json-rescue

Choose your supported agent in the installer. Installing does not authorize payments or fund a wallet. For a free offline demonstration after cloning this repository:

node skills/naif-json-rescue/scripts/check-json.mjs skills/naif-json-rescue/assets/valid.json
node --test tests/naif-json-rescue.test.mjs

Requires Node.js 18+. The local checker validates syntax only; duplicate keys and JSON Schema conformance are outside its scope. The hosted check accepts at most 4096 UTF-8 bytes and supports only bounded trailing-comma repair. See the skill for live discovery, regional policy, spending limits and accurate delivery interpretation.

Live discovery for AI agents

NAIF Gravity is openly discoverable through its machine-readable, read-only entry points:

• A2A Agent Card — identity, skills, protocol interfaces.
• Remote MCP endpoint — Streamable HTTP; MCP clients should negotiate using the MCP protocol (a normal browser GET may return 405).
• AI service catalog and agent catalog API — use live descriptions, eligibility and purchase instructions.
• LLM capability guide and A2A discovery guide.
• A2A Registry listing and Official MCP Registry listing.

This repository's MCP metadata is broadcast to the official MCP Registry via a pinned, verified GitHub Actions publisher when it changes. Listing, crawling, or a registry publish does not prove a visit, a qualified lead, or a sale.

Launch offer — one-time technical services (October 12–26, 2026)

Expired promotion — historical prices below. This offer ended no later than 26 October 2026 at 05:40 UTC. Use the live service catalog and accepted quote for current prices.

Historical offer terms: The launch prices below applied to newly created eligible quotes through 2026-10-26 05:40 UTC (08:40 Saudi time) or the first 10 verified purchases of campaign products, whichever happens first. Existing quotes and past payments retain their original terms. These are prices for bounded technical-service jobs, not per-call x402 tools.

For real-time eligibility and exact currently purchasable prices, agents should call the live agent catalog, then POST /api/agent/quote → POST /api/quote/accept → select an eligible payment rail. Use the amount returned in the accepted quote and checkout; never calculate a discount client-side. USDC on Base and USDT on TRON may be available to eligible international requests; Apple Pay requires a human handoff. Wallet availability follows country and purchase policy. Quote acceptance alone never transfers funds or triggers implementation. Most engineering products require a verified paid Work handoff and are not instant downloadable results.

Instant x402 API tools (separate from launch offer)

These four published full-scope paid API endpoints remain at their existing exact per-call prices until the payment challenge and live catalog are changed together:

Discover supported routes using the x402 manifest, x402 catalog, and OpenAPI. All four are published as self-registered services in 402 Index and are discoverable via Agent402, which currently recognizes four tools on Base. Lite trial rates have not been published: do not request, quote, or announce them as live. A successful 402 challenge or an external directory listing is not proof of a settled sale or inclusion in Coinbase Bazaar.

Individual purchases (no new recurring billing)

The services catalog lists the current individual, one-time technical services. New monthly subscriptions are paused. Pricing, purchase eligibility and region-specific payment options must be obtained from the live store; do not rely on older subscription offers, cached prices or an assumed wallet/payment path. Existing customer subscriptions and past payments are unaffected by this discovery documentation.

Coinbase-compatible x402 tools — self-hosted merchant profile

Publisher: NAIF Gravity · Network: Base Mainnet (eip155:8453) · Asset: USDC · API: x402 v2 · Billing: one-time per call, no subscription. NAIF Gravity's public branded x402 merchant metadata has an official project logo, exact payment requirements, structured input/output schemas, and a link to the live product catalog. A request without payment receives the Payment-Required response and does not deliver the paid artifact.

Agent workflow: consult the x402 manifest or OpenAPI spec, inspect the input schema, POST a sanitized bounded input, authorize the exact 402 payment with the buyer's own eligible wallet, and retrieve the result only after verified settlement. Never send private keys, customer records, tokens, or arbitrary production URLs.

Historical launch promotion: The 12–26 October 2026 discount has ended. Do not apply the old percentage or prices to new quotes. See the live service catalog and the accepted quote for current terms; the x402 API routes below remain separate.

Coinbase indexing status: The services are Coinbase CDP validator-compatible (all four returned valid: true, 25/25 checks on 12 October 2026), but there is currently no confirmed NAIF Gravity direct resource indexed in Coinbase Bazaar. The official seller-discovery guide requires a successfully settled paid call through the CDP facilitator before indexing is expected; validation alone, an ordinary USDC transfer, a GitHub star, or a mention of Coinbase does not constitute a Bazaar listing.

Buy the JSON check with USDC on Base

• Human buyers: open the JSON Validity Check product. Use the payment options offered by the live checkout.
• AI agents: the x402scan listing includes a Try with AgentCash option. The OpenAPI document describes the paid API.
• Price: 1 USDC on Base mainnet (eip155:8453) per bounded JSON check. Wallet network fees may apply. This price is for the JSON check, not every catalog service.

An x402 v2 client sends POST https://naifgravity.com/api/x402/json-validity-check with a JSON body such as {"jsonText":"{\"ok\":true}"}. An unsigned request receives HTTP 402 and a Payment-Required challenge. A compatible client uses the buyer's authorized wallet to sign the advertised USDC payment and retry. A paid result is released only after payment verification and settlement. A browser visit or a GitHub star does not buy the service.

The check accepts one sanitized sample of at most 4096 UTF-8 bytes. It returns a validity diagnosis and supports a bounded trailing-comma repair; it does not repair a full application. Never send secrets, private keys or customer data.

VPN/proxy use is no longer a standalone purchase blocker. The live regional policy still applies: Saudi-classified connections receive Apple Pay; eligible international connections can receive Base USDC. Consult the live payment policy rather than assuming a wallet option is available everywhere. Agent wallets using Base may also need ETH for network fees.

Service discovery

These hosted pages map common developer problems to a focused diagnostic or repair path:

The canonical home page is naifgravity.com. These direct service links make the relationship between each developer problem and its destination explicit for both people and search engines.

Try the MCP health check

Requires Python 3 and uses only the standard library. Run against a server you own or are authorized to test:

git clone https://github.com/naief9961-tech/ai-growth-engine.git
cd ai-growth-engine
python3 tools/mcp_health_check.py https://your-mcp.example/mcp

Replace the example URL with your endpoint. The script negotiates initialize, sends notifications/initialized, and reads tools/list when advertised. It supports JSON and SSE responses, optional bearer authentication through an environment variable, and bounded pagination; it never calls a tool. Protocol errors produce a nonzero exit status without printing server response bodies or secrets.

See the quick start and limitations before interpreting the result. This is a discovery probe for supported handshake-era revisions, not a full MCP conformance suite.

Try the offline webhook signature example to see why parsing and reserializing JSON can break raw-body verification. It uses synthetic data and makes no network requests.

Find the right diagnostic path

Read the troubleshooting index for common 401, 403, invalid_grant, raw-body signature, retry, and idempotency failures. Open an issue using the matching template once you have a minimal reproduction.

GitHub issues are public. Remove tokens, cookies, signing secrets, private keys, payment credentials, and customer data before sharing evidence.

For AI-agent builders

Agent discovery documentation describes the hosted MCP transport, A2A Agent Card, and canonical domain. server.json contains the provider's MCP registry metadata.

Documentation and discovery metadata describe the provider's interfaces; they do not guarantee current availability or certify protocol conformance. Diagnostic discovery does not automatically execute a production repair.

Contribute

Useful contributions include reproducible sanitized examples, clearer troubleshooting steps, and corrections to diagnostic documentation. Explain the problem, expected behavior, and how to reproduce or verify your change. Never include private production logs.

This repository also contains material from the earlier AI Growth Engine project. See the historical README and the existing contribution guide for that context. Historical bounty amounts, payout automation, and endpoint status are not current commitments.

If these diagnostics help you debug an integration, consider starring the repository so other builders can find it.

Service boundary

The hosted service is available at https://naifgravity.com. Public GitHub diagnostic guidance and optional commercial repair workflows are separate; an issue or contribution does not purchase a service or guarantee a repair.