AI Docs
AI Integration Guide
Machine-to-machine integration reference for 8gentHub, including MCP discovery, auth rules, route guardrails, install flow, and reusable API skill exports.
2
Auth modes to keep separate
3
Install helper choices: ZIP, prompt, or npm
6
Supported target platforms for API skill export
Guide scope
Use this page as the app-hosted reference for AI integration route patterns, install/export options, and auth guardrails.
MCP discovery
When an 8gentHub MCP server is configured, use search_listings to browse public listings and get_listing to inspect the latest public manifest and linked skills.
The production Streamable HTTP endpoint is https://api.8genthub.com/mcp; locally, use http://localhost:8001/mcp. Listings are also available as 8gent://listings/{agent_id} resources.
MCP is read-only. Continue using REST for installs, billing, publishing, creator actions, and improvements.
An MCP result is not a REST recommendation_id. Call POST /ai/recommendations before using the AI install route.
Standalone API skill vs marketplace installs
Use the standalone 8gent API Skill package when you want reusable API access instructions that are not tied to a specific 8gent.
Use normal marketplace install endpoints such as /agents/{id}/install* when you want an 8gent-specific export that includes its behavior and linked skill content.
Standalone API skill export routes are POST /ai/skill/export and POST /ai/skill/export/archive.
Both routes require a signed-in user session or Authorization: Bearer <access_token>.
Package defaults are SKILL.md required, TOOLS.md recommended, and no AGENTS.md.
Try API skill export now
Select a platform target to preview package files or download the ZIP.
Quick links
https://api.8genthub.com/mcp (production MCP)
http://localhost:8001/mcp (local MCP)
POST /ai/skill/export
POST /ai/skill/export/archive
POST /ai/recommendations
POST /ai/recommendations/{recommendation_id}/install
POST /ai/installs/{install_id}/improvement-proposals
Auth matrix
/ai/* -> X-API-Key: <user_api_key>
/ai/skill/export* -> Authorization: Bearer <access_token>
/agents/{id}/install* -> Authorization: Bearer <access_token>
/me, /agents, and creator routes -> Authorization: Bearer <access_token>
Wrong: POST /agents/2/install with X-API-Key returns 401.
Right: POST /agents/2/install with Authorization: Bearer <access_token>.
Install helper options
Export ZIP: canonical package files.
Copy Prompt to Install: concrete placement instructions from install-manifest.json.
npm helper install: npx @8gent/install --archive ./agent.zip --project . or --dir.
Operational notes
Generate your X-API-Key from the Account page before using AI recommendation/install routes under /ai/*.
The current AI install charge is 5 tokens per call to POST /ai/recommendations/{recommendation_id}/install, billed to the API key owner.
Recommendation items include linked_skills metadata so AI clients can inspect reusable global skills before install.
AI install packages automatically include linked global skill content. In single-skill compatibility mode, linked skills are embedded into the generated entrypoint instead of shipped as separate locked files.
Use api.8genthub.com for API calls, not app.8genthub.com.