OKXBuilt for the OKX.AI Genesis HackathonX Layer
Product docs

Build, score, and submit ASP drafts with fewer surprises.

This guide explains what ASPForge checks, how to use the validator, how to turn an OpenAPI spec into draft services, and how the MCP server fits into an agent-native workflow.

Overview

What ASPForge does

ASPForge is a pre-submit readiness reviewer for OKX.AI Agent Service Provider listings. It does not submit listings or touch wallets. It helps a builder catch weak or blocking fields before the official review path.

Identity checks

Name, description, and profile-picture readiness.

Service checks

Service name, service copy, type, fee, and endpoint requirements.

Launch checks

OpenAPI tool names, risky routes, auth notes, and generated service drafts.

Validator

Score a draft ASP

  1. Open the validator and enter your ASP identity name and description.
  2. Select an avatar file locally to confirm profile-picture readiness.
  3. Add one or more services.
  4. Choose A2MCP for endpoint/pay-per-call services or A2A for negotiated agent work.
  5. Review every pass, warn, and block finding before submitting to OKX.AI.
SeverityMeaning
PassThe field satisfies the current readiness rule.
WarnThe field can be submitted, but the copy, price, or safety signal looks weak.
BlockFix this before submission because it can stop the listing from being accepted or understood.

OpenAPI launch pack

Convert an API into ASP service drafts

Paste or upload an OpenAPI 3.x document. ASPForge creates draft service candidates, flags unsafe or admin-looking routes, explains auth requirements, and runs the generated services through the same scorecard engine.

Important: Generated A2MCP services intentionally leave fees for the builder to decide. Pricing guidance is heuristic and should be reviewed before publication.

Agent workflow

Use the MCP server

ASPForge exposes the same engine to MCP-capable agent clients.

npm install
npm run mcp

score_asp

Validate a draft ASP identity and service list.

generate_launch_pack

Turn an OpenAPI spec into draft services and score them.

Optional Groq layer

AI suggestions are advisory

When production has a server-side Groq key, ASPForge can suggest stronger service copy and X-post positioning. The model never decides pass/fail status and never overrides deterministic blocks.

Hackathon submission

Final checklist

  • Live app: https://www.aspforge.xyz
  • OKX.AI listing: https://www.okx.ai/agents/4895
  • GitHub repo: https://github.com/mystiquemide/aspforge
  • Record a demo video under 90 seconds.
  • Publish an X post with #OKXAI and the demo attached or linked.
  • Submit the final Google form before the deadline.

Limitations

What ASPForge does not do

  • Does not guarantee OKX approval.
  • Does not submit listings for users.
  • Does not sign transactions or manage wallets.
  • Does not treat heuristic pricing as market data.
  • Does not let Groq override deterministic findings.