> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > ## Agent Instructions (AIsa) > > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Paid calls need approval first. Docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP discovery are free to read. Before any paid, dynamically priced, or high-cost call, state the exact scope, rate, and maximum USD exposure, then wait for a separate user message approving that scope and cap. A request to collect data is not approval; do not send unapproved probes. Full rule: https://aisa.one/docs/llms.txt # List Generation > Build targeted company lists from structured filters or natural language, with optional enrichment. Build a targeted company list from structured `filters` or a natural-language `query`, with optional per-section enrichment on every returned company. This is deal sourcing: "Series A fintechs in Singapore", "bootstrapped HR-tech companies in Europe with 50-200 employees" — expressed as filters, run repeatedly. Prefer [`post_akta_filter_builder`](/docs/api-reference/akta/post_list-filter-builder) to turn plain language into a reviewable `filters` object first; pass `query` directly only for one-shot searches (it carries a surcharge and is not reproducible). Pricing: base $0.05 per call (+$0.10 with `query`) + \$0.02 per returned company + per-section enrichment costs × company count. **First time?** Point any MCP client at `https://mcp.aisa.one/mcp` — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through five tools: `search`, `list_categories` and `get_details` are free, `use` and `batch_use` are billed per call. Setup per client is in [Connect via MCP](/docs/agent-quickstart); the live tool list and what each call costs are on [aisa.one/mcp](https://aisa.one/mcp#connect). [Set this endpoint up in your agent →](https://aisa.one/mcp?from=/api-reference/akta/post_list-generate-companies) ## Cost and request rules Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. * **Default request reference estimate (USD):** 0.05 * **Cost contract:** fixed\_success * **Settlement evidence source:** request\_snapshot ## OpenAPI ````yaml openapi/akta.json POST /apis/v1/akta/list/generate/companies openapi: 3.1.0 info: description: '' title: Akta version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/akta/company/addition-requests - /apis/v1/akta/company/enrichment - /apis/v1/akta/company/search - /apis/v1/akta/industry/search - /apis/v1/akta/list/filter-builder - /apis/v1/akta/list/generate/companies - /apis/v1/akta/status/{request_id} x-aisa-document: facts_hash: d6697de3e5c016d4bf4c7fb0c4b834f38524cf92fb24739a3f461f45df5d3ce2 generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '18' response_pending: [] document_hash: sha256:c90c9ff7caab816a3f4309e4ded84c10a15bc10d38f9a61bd8f4289b753a69bd x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: akta x-aisa-catalogs: akta: title: Akta description: '' x-aisa-document: facts_hash: d6697de3e5c016d4bf4c7fb0c4b834f38524cf92fb24739a3f461f45df5d3ce2 generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/akta/list/generate/companies: post: tags: - list-generation summary: List Generation description: >- Build targeted company lists from structured filters or a natural-language query, with optional per-section enrichment. operationId: post_akta_list_generate requestBody: required: true content: application/json: schema: type: object properties: query: type: string description: >- Natural language search query (e.g. 'SaaS companies in the US with Series A funding'). Cannot be used with filters. filters: type: object additionalProperties: true description: >- Structured filter conditions. Use the Filter Builder API to generate valid filters. Cannot be used with query. See filter options at /api-reference/listgen-api. sections: type: array items: type: string description: >- Data enrichment sections to include. Values: firmographic, business_model, company_assessment, trust_signal, company_hierarchy, digital_presence, financial_estimate, location, management_profile, product_offering, strategic_signal, customer_profile, industry, technology, funding_detail (Subscription, Enterprise), mna_and_investment (Subscription, Enterprise) sort_by: type: string enum: - relevance - revenue_estimate - valuation_estimate - employee_range - total_funding - founded_year description: 'Field to sort results by. Default: relevance' sort_order: type: string enum: - asc - desc description: 'Sort direction. Default: desc' limit: type: integer description: 'Maximum companies to return. Default: 50, Max: 500' offset: type: integer description: 'Number of results to skip for pagination. Default: 0' responses: '200': description: Successful response content: application/json: schema: $ref: >- #/components/schemas/Response73D692Ab31Ca_ListGenerationResponse default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: Response73D692Ab31Ca_ListGenerationResponse: type: object properties: data: type: array items: type: object description: >- Company object with identity fields (uuid, name, website) plus any requested enrichment sections. count: type: integer description: Number of companies returned. total_count: type: integer description: Total matching companies. Capped at 500. credits_consumed: type: number format: float description: Credits consumed. Returns 0 when no enrichment sections requested. securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.