{
  "markdown": "# AskAIs AI Receipt Generator MCP\n\n[![CI](https://github.com/MiniCodeTeam/askais-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/MiniCodeTeam/askais-mcp/actions/workflows/ci.yml)\n[![MCP](https://img.shields.io/badge/MCP-Streamable_HTTP-5ee6b3)](https://modelcontextprotocol.io/)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\nAskAIs MCP is the remote Model Context Protocol server for the **AskAIs AI Receipt Generator API**. It lets Cursor, Claude Code, Codex, Gemini CLI, and other MCP clients create professional receipt PDFs, return structured receipt data, and check prepaid API credit through one endpoint:\n\n```text\nhttps://askais.com/mcp\n```\n\nNo website login is required to connect. An eligible new user can ask their AI client to run `create_free_account`, accept the Terms and Privacy Policy, and receive one-time account credentials plus introductory API credit.\n\n## MCP tools\n\n| Tool | Purpose |\n| --- | --- |\n| `get_usage_rules` | Read pricing, privacy, and acceptable-use rules. |\n| `create_free_account` | Create an account and receive one-time credentials and free credit. |\n| `generate_receipt` | Generate a downloadable receipt PDF from structured transaction data. |\n| `get_balance` | Check remaining API credit. |\n\n## Quick start\n\n### Cursor\n\nAdd the remote server in Cursor's MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"askais\": {\n      \"url\": \"https://askais.com/mcp\"\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http askais https://askais.com/mcp\n```\n\n### Codex\n\n```bash\ncodex mcp add askais --url https://askais.com/mcp\n```\n\n### Gemini CLI\n\nAdd this server to the `mcpServers` object in Gemini CLI settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"askais\": {\n      \"httpUrl\": \"https://askais.com/mcp\"\n    }\n  }\n}\n```\n\nClient configuration fields can change between client versions. If your client uses `serverUrl` or `url` instead of the example field, keep the endpoint exactly `https://askais.com/mcp` and select **Streamable HTTP**.\n\n## Example prompts\n\n```text\nConnect to AskAIs, show me the usage rules, and create a free account after I confirm the terms.\n```\n\n```text\nCreate a legitimate USD receipt for Acme Studio: two hours of design consulting at $75 per hour. Show me the PDF link and remaining balance.\n```\n\n## Existing AskAIs accounts\n\nExisting developers may send an API key as an HTTP bearer token:\n\n```http\nAuthorization: Bearer ak_live_your_key\n```\n\nThe full API key may also be passed to `generate_receipt` or `get_balance`. Store keys in your MCP client's secret storage or environment configuration—not in source control.\n\n## Pricing and free credit\n\n- Receipt generation costs **US$0.10 per successful PDF**.\n- Failed generation is not charged.\n- Introductory credit is intended for evaluation and is limited by anti-abuse controls.\n- Learn more on the dedicated [AskAIs MCP page](https://askais.com/en/mcp). Paid credit and keys can be managed in the [developer console](https://askais.com/en/developers).\n\n## Acceptable use\n\nAskAIs is for legitimate business records. Do not use it to fabricate purchases, expenses, tax evidence, reimbursements, warranties, or proof of payment. Do not impersonate a merchant or include personal data you are not authorized to process.\n\nUse of the service is governed by the [Terms of Service](https://askais.com/en/terms) and [Privacy Policy](https://askais.com/en/privacy).\n\n## Self-hosting the gateway\n\nThe public gateway can be built and run locally, but free-account provisioning requires a private gateway secret issued by AskAIs. Existing API-key tools work against the public API without that secret.\n\n```bash\nnpm install\nnpm run build\nHOST=127.0.0.1 PORT=3105 npm start\n```\n\nEnvironment variables are documented in [`.env.example`](.env.example). Never commit `ASKAIS_MCP_GATEWAY_SECRET`.\n\n## Architecture\n\n```text\nCursor / Claude Code / Codex / Gemini\n                  |\n                  v\n       https://askais.com/mcp\n                  |\n                  v\n     AskAIs MCP gateway (Streamable HTTP)\n                  |\n                  v\n     Receipt API / billing / PDF / database\n```\n\n## Development\n\n```bash\nnpm ci\nnpm run typecheck\nnpm test\nnpm run build\n```\n\nSecurity reports: `security@askais.com`  \nSupport: `support@askais.com`\n\n<!-- mcp-name: io.github.MiniCodeTeam/askais-mcp -->\n",
  "bytes": 4348,
  "sha": "fc877d200e9a9b9f0c369d1e0d4c97fb58272e0ee3531aff5c064eac6b749b5b",
  "repo_slug": "minicodeteam/askais-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_minicodeteam_askais_mcp_12d43c1f/readme"
}