Claude Code / Codex upload

Launch your built product on jocoHunt with MCP

From your development workspace, an agent can prepare the product name, description, URL, images, and YouTube link, then submit the product to jocoHunt.

01

Create a personal API key

Create a Claude Code / Codex upload key from Settings. Store it safely because it is only shown once.

02

Register MCP

Register the hosted MCP endpoint and your API key with the commands below. You do not need to clone the repo or install an npm package.

03

Ask the agent to upload

Ask your agent to submit the current project to jocoHunt. It validates the payload before creating the product.

Codex registration command

export JOCOHUNT_API_KEY=joco_live_발급받은_키
codex mcp add jocohunt \
  --url https://jocohunt.com/api/mcp \
  --bearer-token-env-var JOCOHUNT_API_KEY

Claude Code registration command

export JOCOHUNT_API_KEY=joco_live_발급받은_키
claude mcp add --transport http jocohunt \
  https://jocohunt.com/api/mcp \
  -H "Authorization: Bearer $JOCOHUNT_API_KEY"

Prompt example

jocohunt MCP를 사용해서 이 프로젝트를 조코헌트에 업로드해줘. README와 package.json을 참고하고, 로고/스크린샷 후보를 찾아서 업로드한 다음 jocohunt_submit_product까지 실행해줘.

Submission form fields covered by MCP

MCP does not click through the browser form. It builds the same submission payload that the jocoHunt form uses, validates it, and submits it.

When an agent connects for the first time, call jocohunt_get_submission_guide first to get required fields, optional fields, upload order, and an example payload as JSON.

Step 1 Basics

Fills `name`, `tagline`, `websiteUrl`, `githubUrl`, `twitterUrl`, `categories`, `stage`, and `pricingModel`.

Step 2 Media

Fills `logoUrl`, `galleryImages`, `demoVideoUrl`, and `description`. The agent reads image files as base64, sends them to `jocohunt_upload_asset`, then uses the returned URLs.

Step 3 Maker

Fills `teamMembers`, `launchNow`, and `scheduledDate`. Team members are an array of `{ name, role, handle }`.

Screenshots are saved in galleryImages array order. Put the primary screenshot first when you want it to appear first.

Daily limits

To reduce spam, the default limits are 3 product submissions and 20 asset uploads per day.

Supported submission materials

  • Product name and tagline
  • Website/GitHub/Twitter URLs
  • Logo and screenshots
  • Long description
  • YouTube demo link

MCP tools

  • jocohunt_get_submission_guide
  • jocohunt_get_categories
  • jocohunt_get_my_quota
  • jocohunt_upload_asset
  • jocohunt_validate_submission
  • jocohunt_submit_product

Troubleshooting

  • If the agent does not know which values to fill, ask it to call jocohunt_get_submission_guide first.
  • For Codex, put only the key in JOCOHUNT_API_KEY and connect with --bearer-token-env-var.
  • For Claude Code, confirm the HTTP transport and Authorization header were registered together.
  • Run jocohunt_get_my_quota before submitting.
  • Pass base64 and contentType to jocohunt_upload_asset first, then use the returned URLs in the submission.