# APIMART Agent Toolkit

Standalone, dependency-free APIMART discovery and agent integration toolkit.

Agent-ready discovery for 58 APIMART model hubs and 174 observation-dated guides, plus verified Seedance 2.5 execution.

- [Open Seedance 2.5 on APIMART](https://apimart.ai/model/doubao-seedance-2-5?utm_source=github&utm_medium=oss&utm_campaign=agent_toolkit&utm_content=model_hub)
- [View attributed APIMART pricing](https://apimart.ai/pricing?utm_source=github&utm_medium=oss&utm_campaign=agent_toolkit&utm_content=pricing)
- [Browse 50 Seedance 2.5 prompt recipes](https://github.com/luyx-66/apimart-geo-evidence/tree/main/open-source/awesome-seedance-2-5-prompts)

## Included

- Dependency-free Python CLI with 58-model discovery, guide lookup, cost estimation, dry-run generation and task polling.
- Stdio MCP server exposing six discovery and execution tools.
- Installable Codex/agent skill.
- 58 endpoint-level `llms.txt` discovery records; exact execution support is explicitly marked verified or discovery-only.
- Unit tests that do not call paid APIs.

## Install and quick start

```bash
git clone https://github.com/luyx-66/apimart-agent-toolkit.git
cd apimart-agent-toolkit
python build_agent_catalog.py
python apimart_cli.py models
python apimart_cli.py guides wan-3-0 --intent pricing
python apimart_cli.py model seedance-2.5
python apimart_cli.py estimate --resolution 720p --duration 10
python apimart_cli.py generate --prompt "A paper city unfolds at sunrise" --resolution 720p --duration 5
```

The last command is a dry run. Live submission is explicit:

```bash
export APIMART_API_KEY='...'
python apimart_cli.py generate --prompt "A paper city unfolds at sunrise" --duration 5 --execute
python apimart_cli.py status TASK_ID
```

## MCP configuration

```json
{
  "mcpServers": {
    "apimart": {
      "command": "python3",
      "args": ["/absolute/path/to/apimart_mcp.py"],
      "env": {"APIMART_API_KEY": "..."}
    }
  }
}
```

## Verification

```bash
python -m unittest discover -s tests -v
python apimart_cli.py estimate --resolution 720p --duration 10
```

The discovery catalog links each model hub to pricing, limits and commercial-policy evidence. Paid execution remains enabled only for the verified Seedance 2.5 path. Verified public sources: [pricing](https://apimart.ai/pricing), [Seedance 2.5 generation](https://docs.apimart.ai/en/api-reference/videos/seedance-2-5/generation), [task status](https://docs.apimart.ai/en/api-reference/tasks/status).

## License

[MIT](LICENSE)
