NAIF Gravity — MCP & Integration Diagnostics

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.

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.

What’s new: Micro Tools V2 — free preview, paid report

Broken JSON? Unexpected API response? Need consistent data output? Preview your sanitized sample at no charge, then choose a one-time report if the bounded result is useful. No subscription and no payment during preview.

Try a free preview of the three tools → · Browse the live catalog

Simple agent-to-report flow: request a sample preview (POST /api/micro-v2/preview), request and accept a fixed-price quote (POST /api/agent/quote → POST /api/quote/accept), select an eligible checkout rail returned by the response, then retrieve the bounded report (POST /api/micro-v2/deliver) using the private delivery token after payment verification. Base USDC and TRON USDT may be available to eligible international buyers; Saudi-classified buyers use Apple Pay with human authorization. Agent-wallet checkout instructions are not an instruction to transfer funds automatically.

All three tools accept sanitized, bounded samples (maximum 4,096 UTF-8 bytes). Paid V2 inputs and reports are encrypted at rest; the original input is cleared from active records after report generation, with report retrieval limited to seven days. Never submit secrets, raw customer records, private keys or payment credentials. Per-call x402 paid API tools are a separate purchase path; the fourth CSV tool remains $5.

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)

Live automatic discount, no coupon or manual agent approval. The launch prices below apply 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.

Separate temporary launch discount: 14 scoped engineering/repair services have automatic promotional prices in the live agent catalog, with human-facing prices. No coupon is needed; a newly accepted quote fixes the amount. The promotion expires on 26 October 2026 at 05:40 UTC or after the first ten verified eligible purchases, whichever comes first. This discount does not apply to the four instant x402 API prices above.

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.