> ## 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 # Filter Builder > Convert a natural-language description of target companies into structured filters for list generation. Convert a natural-language description of your target companies into the structured `filters` object accepted by [`post_akta_list_generate`](/docs/api-reference/akta/post_list-generate-companies). "series a companies in mumbai working in climate tech" becomes `location.hq.city: ["Mumbai"]`, `funding_detail.funding_overview.funding_stage: ["series_a"]`, `industry.industry: [...]` — with the industry codes resolved for you. Returns no companies itself. Costs the same \$0.025 as the natural-language surcharge on list generation, but the output is reviewable, tweakable, cacheable, and re-runnable with `filters`. **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-filter-builder) ## 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.025 * **Cost contract:** fixed\_success * **Settlement evidence source:** request\_snapshot ## OpenAPI ````yaml openapi/akta.json POST /apis/v1/akta/list/filter-builder 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/filter-builder: post: tags: - list-generation summary: Filter Builder description: >- Convert a natural-language description of target companies into a structured filters object for the List Generation API. operationId: post_akta_filter_builder requestBody: required: true content: application/json: schema: type: object properties: query: type: string description: >- Natural language description of target companies (e.g. 'series a companies in mumbai working in climate tech'). required: - query responses: '200': description: Successful response content: application/json: schema: $ref: >- #/components/schemas/Response73D692Ab31Ca_TranslateQueryResponse default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: Response73D692Ab31Ca_TranslateQueryResponse: type: object properties: data: type: object properties: filters: type: object description: >- Structured filters object equivalent to the input query, using dotted-path filter keys. credits_consumed: type: number format: float securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.