{
  "markdown": "# ImagineVid Agent Tools AI\n\nOpen-source distribution packages for [ImagineVid](https://imaginevid.io/), an\nAI generation platform for images, videos, and music. This repository contains\nthe typed REST client, a CLI, and a local stdio MCP adapter. The hosted MCP\nserver remains the source of truth for identity, OAuth consent, scopes, credits,\nquotes, idempotency, owned assets, and provider lifecycle.\n\n## Choose a connection\n\n### Hosted MCP\n\nUse the OAuth-protected Streamable HTTP endpoint when your host supports remote\nMCP servers:\n\n```json\n{\n  \"mcpServers\": {\n    \"imaginevid\": {\n      \"url\": \"https://imaginevid.io/api/mcp\"\n    }\n  }\n}\n```\n\nThe host handles OAuth and explicit consent. The endpoint exposes\n`models_list`, `credits_get`, `generation_quote`, `generation_create`, and\n`generation_get`. See the [ImagineVid website](https://imaginevid.io/) for the\nproduct and account flow.\n\n### Local stdio MCP\n\nAfter the npm package is released, configure a local host with:\n\n```json\n{\n  \"mcpServers\": {\n    \"imaginevid\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"imaginevid-mcp\"],\n      \"env\": {\n        \"IMAGINEVID_API_KEY\": \"${IMAGINEVID_API_KEY}\",\n        \"IMAGINEVID_BASE_URL\": \"https://imaginevid.io\"\n      }\n    }\n  }\n}\n```\n\nThe local adapter uses a scoped API key, never prints it, and never retries an\nambiguous `submission_unknown` result. It accepts product capability values and\nowned asset IDs, not provider parameters, arbitrary remote URLs, or inline\nbase64 media.\n\n### CLI\n\nAfter the npm package is released:\n\n```bash\nnpm install --global imaginevid-cli\nexport IMAGINEVID_API_KEY=\"...\"\nimaginevid models list\nimaginevid credits\n```\n\nThe CLI also supports `assets upload`, `generate`, `generations get`, and\n`generations wait`. `generate` quotes first and requires an exact explicit\ncredit confirmation plus a stable idempotency key.\n\n## Development\n\n```bash\npnpm install\npnpm test\npnpm build\n```\n\nThe public package metadata and release files live in:\n\n- [`imaginevid-client`](./packages/client), the typed Agent REST v1 client.\n- [`imaginevid-cli`](./packages/cli), the command-line adapter.\n- [`imaginevid-mcp`](./packages/mcp), the local stdio MCP adapter.\n- [`server.json`](./server.json), the hosted MCP Registry metadata.\n\nFor product documentation, generation tools, and account access, visit the\n[ImagineVid website](https://imaginevid.io/). Source issues belong in this\n[GitHub repository](https://github.com/imagineVid/imaginevid-agent-tools-ai).\n\n## Security and license\n\nDo not commit API keys or account configuration. The hosted endpoint uses OAuth;\nthe local adapters read credentials from the environment or an owner-only local\nconfig file. Report package or security issues through the\n[ImagineVid support page](https://imaginevid.io/contact).\n\nThe public distribution code is available under [MIT-0](./LICENSE).\n",
  "bytes": 2857,
  "sha": "132b6c6e21b49d32c90baa98e565f360be5f5fb35aa30aeff895eac54ad494cf",
  "repo_slug": "imaginevid/imaginevid-agent-tools-ai",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_imaginevid_imaginevid_ai_generation_ac5f9528/readme"
}