# agents.txt — Current (getcurrent.ca)

> Machine-readable guidance for AI agents and automated clients. Current is a
> Canadian Know-Your-Business (KYB) platform. This file states what agents are
> permitted to do and documents how to buy a Canadian corporate profile report
> programmatically, without a human in the loop beyond payment.

Owner: Current Future Labs Inc.
Contact: contact@getcurrent.ca
Developer docs: https://docs.getcurrent.ca
Content for LLMs: https://getcurrent.ca/llms.txt
Sitemap: https://getcurrent.ca/sitemap.xml
OpenAPI: https://getcurrent.ca/openapi.json
MCP server (Streamable HTTP): https://getcurrent.ca/api/mcp
MCP manifest: https://getcurrent.ca/.well-known/mcp.json

## When to use Current

Use Current when a task involves a registered Canadian business and needs
registry-of-record data or an official document:
- Buy an official corporate profile report (legal name, registration number,
  registered address, directors/officers, beneficial owners where available).
- Order a PPSA / lien search against a Canadian business debtor (or Quebec RDPRM).
- Look up or verify a Canadian business across federal and provincial registries.
Do not use it for non-Canadian companies or consumer/personal credit checks.

You can call the endpoints below directly, or connect to the MCP server at
https://getcurrent.ca/api/mcp (tools: search_canadian_business,
order_corporate_profile_report, order_ppsa_search). The same surface is
described machine-readably in https://getcurrent.ca/openapi.json.

## Policy — what agents may do

Allowed:
- Read and index every public page (see /llms.txt and /sitemap.xml).
- Call the public search endpoint to look up Canadian businesses.
- Call the public checkout endpoints to buy a corporate profile report or a PPSA
  (lien) search, including on behalf of a human who has asked you to.
- Follow the returned Stripe Checkout URL to complete payment.

Not allowed:
- Do not attempt to access, enumerate, or brute-force any /api/ path not
  documented in this file.
- Do not submit orders you have not been instructed to place, or use email
  addresses you are not authorized to use.
- Do not scrape at a rate that degrades service.

Etiquette:
- Send a descriptive User-Agent that identifies your agent and an operator contact.
- The endpoints documented below are the supported, stable interface for agents.
  Other /api/ paths are disallowed for crawlers via /robots.txt and may change
  without notice.

## Product — Corporate Profile Report

- What it is: an official corporate profile report from a Canadian business
  registry (legal name, registration number, registered address, directors and
  officers, and beneficial owners where the registry provides them).
- Price: CA$30.00, one-time. Disbursement fees included. No account required.
- Delivery: PDF emailed to the buyer, usually within minutes (rarely up to ~1 hour).
- Currency: CAD. Payment is processed by Stripe.
- Human-facing page: https://getcurrent.ca/corporate-profile-report

## How to buy a report

Two steps. Step 1 is optional if you already have the exact legal name,
jurisdiction, and registration number.

### Step 1 (optional) — Look up the business and its registration number

    GET https://getcurrent.ca/api/corporate-search?q={business name}
    Accept: application/json

`q` must be at least 2 characters. Response:

    {
      "results": [
        {
          "name": "ACME CORPORATION INC.",
          "registrationNumber": "1234567",
          "jurisdiction": "ON",
          "status": "Active",
          "city": "Toronto",
          "province": "Ontario"
        }
      ]
    }

Use a result's `name`, `registrationNumber`, and `jurisdiction` directly in Step 2.
`jurisdiction` is the two-letter code; `province` is the registered office's full
province name and is not a valid jurisdiction value.

### Step 2 — Create a checkout session

    POST https://getcurrent.ca/api/checkout
    Content-Type: application/json

    {
      "businessName": "ACME CORPORATION INC.",
      "registrationNumber": "1234567",
      "jurisdiction": "ON",
      "email": "buyer@example.com"
    }

All four fields are required. `email` is where the report PDF is delivered — use
an address the user controls. `registrationNumber` is the registry number (NOT the
9-digit CRA Business Number); leading/trailing spaces are trimmed automatically.

Success response (HTTP 200):

    { "url": "https://checkout.stripe.com/..." }

Direct the user to this `url` (or open it) to complete payment. The report is
emailed after the Stripe payment succeeds. On error the response is a non-200
status with `{ "error": "..." }`.

### Jurisdiction codes

FED (Federal / Corporations Canada), AB (Alberta), BC (British Columbia),
MB (Manitoba), NB (New Brunswick), NL (Newfoundland and Labrador),
NT (Northwest Territories), NS (Nova Scotia), NU (Nunavut), ON (Ontario),
PE (Prince Edward Island), QC (Quebec), SK (Saskatchewan), YT (Yukon).

## Product — PPSA (lien) Search

- What it is: an official Personal Property Security Act (PPSA) search against a
  business debtor, sourced directly from a Canadian province or territory's
  personal property registry (or Quebec's RDPRM). It reveals registered financing
  statements — public notices that a creditor holds a security interest in the
  business's personal property — including the secured party and a collateral
  description.
- Price: CA$40.00, one-time. No account required.
- Delivery: report emailed to the buyer, typically within one business day
  (fulfilled manually by Current, so slower than the corporate profile report).
- Currency: CAD. Payment is processed by Stripe.
- Human-facing page: https://getcurrent.ca/ppsa-search

## How to buy a PPSA search

Two steps. Step 1 is optional if you already know the debtor's exact legal name
and the jurisdiction to search.

### Step 1 (optional) — Look up the business and its jurisdiction

    GET https://getcurrent.ca/api/corporate-search?q={business name}
    Accept: application/json

Use a result's `name` and `jurisdiction` (see response shape under "How to buy a
report" above). Note: there is no federal PPSA registry, so a `FED` jurisdiction
result cannot be searched — pick the province or territory where the business
operates or holds assets and pass its two-letter code from the list below (the
result's `province` field is a full province name, not a code).

### Step 2 — Create a PPSA checkout session

    POST https://getcurrent.ca/api/ppsa-checkout
    Content-Type: application/json

    {
      "businessName": "ACME CORPORATION INC.",
      "jurisdiction": "ON",
      "email": "buyer@example.com"
    }

All three fields are required. `businessName` is the debtor's legal name (2–150
characters). `jurisdiction` must be one of the PPSA jurisdiction codes below.
`email` is where the report is delivered — use an address the user controls.

Success response (HTTP 200):

    { "url": "https://checkout.stripe.com/..." }

Direct the user to this `url` (or open it) to complete payment. The report is
emailed after the Stripe payment succeeds. On error the response is a non-200
status with `{ "error": "..." }`.

### PPSA jurisdiction codes

AB (Alberta), BC (British Columbia), MB (Manitoba), NB (New Brunswick),
NL (Newfoundland and Labrador), NT (Northwest Territories), NS (Nova Scotia),
NU (Nunavut), ON (Ontario), PE (Prince Edward Island), QC (Quebec — RDPRM),
SK (Saskatchewan), YT (Yukon). There is no federal (FED) PPSA registry.

## Legal

- Terms of Service: https://getcurrent.ca/terms
- Privacy Policy: https://getcurrent.ca/privacy
- Refund Policy: https://getcurrent.ca/refunds