AskAIs AI Receipt Generator MCP

AskAIs 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:

https://askais.com/mcp

No 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.

MCP tools

Tool	Purpose
get_usage_rules	Read pricing, privacy, and acceptable-use rules.
create_free_account	Create an account and receive one-time credentials and free credit.
generate_receipt	Generate a downloadable receipt PDF from structured transaction data.
get_balance	Check remaining API credit.

Quick start

Cursor

Add the remote server in Cursor's MCP settings:

{
  "mcpServers": {
    "askais": {
      "url": "https://askais.com/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http askais https://askais.com/mcp

Codex

codex mcp add askais --url https://askais.com/mcp

Gemini CLI

Add this server to the mcpServers object in Gemini CLI settings:

{
  "mcpServers": {
    "askais": {
      "httpUrl": "https://askais.com/mcp"
    }
  }
}

Client 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.

Example prompts

Connect to AskAIs, show me the usage rules, and create a free account after I confirm the terms.

Create a legitimate USD receipt for Acme Studio: two hours of design consulting at $75 per hour. Show me the PDF link and remaining balance.

Existing AskAIs accounts

Existing developers may send an API key as an HTTP bearer token:

Authorization: Bearer ak_live_your_key

The 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.

Pricing and free credit

• Receipt generation costs US$0.10 per successful PDF.
• Failed generation is not charged.
• Introductory credit is intended for evaluation and is limited by anti-abuse controls.
• Learn more on the dedicated AskAIs MCP page. Paid credit and keys can be managed in the developer console.

Acceptable use

AskAIs 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.

Use of the service is governed by the Terms of Service and Privacy Policy.

Self-hosting the gateway

The 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.

npm install
npm run build
HOST=127.0.0.1 PORT=3105 npm start

Environment variables are documented in .env.example. Never commit ASKAIS_MCP_GATEWAY_SECRET.

Architecture

Cursor / Claude Code / Codex / Gemini
                  |
                  v
       https://askais.com/mcp
                  |
                  v
     AskAIs MCP gateway (Streamable HTTP)
                  |
                  v
     Receipt API / billing / PDF / database

Development

npm ci
npm run typecheck
npm test
npm run build

Security reports: security@askais.com
Support: support@askais.com

<!-- mcp-name: io.github.MiniCodeTeam/askais-mcp -->