# HelpMyAgent (remote · api.helpmyagent.com)

Pay-per-call data APIs for AI agents: business, compliance, procurement, VAT and IBAN via x402.

- Trust score: 73/100 (medium)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-20

## Components

- remote · `api.helpmyagent.com`: 73/100 (this document), [markdown](https://verifymcp.io/servers/helpmyagent-helpmyagent/api.md), [page](https://verifymcp.io/servers/helpmyagent-helpmyagent/api)

## Channel facts

- Endpoint: `https://api.helpmyagent.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.5.9`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-20.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS check failed: the endpoint is reachable over plaintext HTTP.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 64/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 16730 tokens (~283/item across 59 items; 59 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 57/100
  - Stability observed for 17 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 59 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 60 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the HelpMyAgent MCP server?

HelpMyAgent is a hosted endpoint at https://api.helpmyagent.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http helpmyagent-helpmyagent 'https://api.helpmyagent.com/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "helpmyagent-helpmyagent": {
      "url": "https://api.helpmyagent.com/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "helpmyagent-helpmyagent": {
      "type": "http",
      "url": "https://api.helpmyagent.com/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.helpmyagent-helpmyagent]
url = "https://api.helpmyagent.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "helpmyagent-helpmyagent": {
      "type": "remote",
      "url": "https://api.helpmyagent.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add helpmyagent-helpmyagent --url 'https://api.helpmyagent.com/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  helpmyagent-helpmyagent:
    url: "https://api.helpmyagent.com/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "helpmyagent-helpmyagent": {
      "Transport": "http",
      "Url": "https://api.helpmyagent.com/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add helpmyagent-helpmyagent -t streamable-http -u 'https://api.helpmyagent.com/mcp'
```

### Other

```json
{
  "mcpServers": {
    "helpmyagent-helpmyagent": {
      "type": "http",
      "url": "https://api.helpmyagent.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-20 (score 73, +1)

- [security regression] A breaking change shipped without a version bump: still v1
- [security regression] Tool “company_fr_competitors” was removed
- [security regression] Tool “company_fr_kyb” was removed
- [security regression] Tool “company_fr_legal_announcements_since” was removed
- [security regression] Tool “company_fr_regulator_alerts” was removed
- [security] Tool “company_fr_compliance” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_intelligence” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_kyb_batch” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_legal_announcements_search” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_payment_context” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_peers” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_public_contract_competitors” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_regulatory_approvals” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_supplier_verification” rewrote its description, which is the text the model reads
- [cosmetic] “company_fr_intelligence” added an optional parameter “domain”

### 2026-09-18 (score 72, +1)

No change was recorded against any check on this day. Stability & Change Management went from 47 to 50. That category is still filling its 30-day observation window: 14 days of observed history at the previous scan, 15 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-16 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 40 to 43. That category is still filling its 30-day observation window: 12 days of observed history at the previous scan, 13 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-14 (score 70, +1)

No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-11 (score 69, +1)

- [functional regression] Schema quality: 15940 → 17836
- [functional] New tool “real_estate_fr_dpe”
- [functional] New tool “real_estate_fr_market”
- [functional] New tool “real_estate_fr_parcel”
- [functional] New tool “real_estate_fr_risks”
- [functional] New tool “real_estate_fr_transactions”
- [functional] New tool “real_estate_fr_valuation”

### 2026-09-10 (score 68, 0)

- [security] Tool “company_fr_industrial_risk” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_invoice_check” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_sector_statistics” rewrote its description, which is the text the model reads
- [security] Tool “procurement_fr_deadlines” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: 13492 → 15940
- [functional] New tool “company_fr_changes”
- [functional] New tool “company_fr_closures”
- [functional] New tool “company_fr_establishments”
- [functional] New tool “company_fr_history”
- [functional] New tool “company_fr_new”
- [functional] New tool “company_fr_successions”
- [functional] New tool “procurement_fr_awards”
- [functional] New tool “procurement_fr_market”
- [functional] New tool “procurement_fr_trends”
- [cosmetic] “company_fr_invoice_check” added an optional parameter “invoice”
- [cosmetic] Tool “company_fr_invoice_check” changed its title: French Invoice Identifier Check → French Invoice Validation
- [cosmetic] Tool “procurement_fr_deadlines” changed its title: French Public Contract Expiry Estimates → French Public Contract Expiry & Renewal Signals

### 2026-09-09 (score 68, +1)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “company_fr_compliance” rewrote its description, which is the text the model reads
- [security] Tool “describe_api” rewrote its description, which is the text the model reads
- [security] Tool “list_categories” rewrote its description, which is the text the model reads
- [security] Tool “search_apis” rewrote its description, which is the text the model reads
- [cosmetic] “describe_api” reworded the description of “endpoint”
- [cosmetic] “search_apis” reworded the description of “category”

### 2026-09-08 (score 67, +9)

- [security improvement] Authorization: unverified → partial
- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “company_fr_aids” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_benchmark” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_certifications” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_compare” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_competitors” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_compliance” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_default_score” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_director_mandates” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_directors” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_e_invoice” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_events” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_financials” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_industrial_risk” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_intelligence” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_invoice_check” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_kyb” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_kyb_batch” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_legal_announcements_search” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_legal_announcements_since” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_lobbying” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_nearby” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_opportunities” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_payment_context” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_peers” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_profile” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_prospecting” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_public_contract_competitors” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_public_contracts” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_public_contracts_eu” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_regulator_alerts” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_regulatory_approvals” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_report” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_risk” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_risk_reading” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_search” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_sector_statistics” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_signals” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_supplier_verification” rewrote its description, which is the text the model reads
- [security] Tool “company_fr_verify” rewrote its description, which is the text the model reads
- [security] Tool “compliance_name_screen” rewrote its description, which is the text the model reads
- [security] Tool “iban_validate” rewrote its description, which is the text the model reads
- [security] Tool “procurement_fr_buyer_profile” rewrote its description, which is the text the model reads
- [security] Tool “procurement_fr_deadlines” rewrote its description, which is the text the model reads
- [security] Tool “procurement_fr_search” rewrote its description, which is the text the model reads
- [security] Tool “vat_eu_validate” rewrote its description, which is the text the model reads
- [security] Tool “describe_api” rewrote its description, which is the text the model reads
- [security] Tool “list_categories” rewrote its description, which is the text the model reads
- [security] Tool “search_apis” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: 158 → 284
- [functional improvement] Tool coverage: 29% → 100%
- [functional] Schema quality: good → excellent
- [cosmetic] “company_fr_benchmark” reworded the description of “identifier”
- [cosmetic] “company_fr_benchmark” reworded the description of “peer_limit”
- [cosmetic] “company_fr_benchmark” reworded the description of “scope”
- [cosmetic] “company_fr_compare” reworded the description of “identifiers”
- [cosmetic] “company_fr_competitors” reworded the description of “identifier”
- [cosmetic] “company_fr_competitors” reworded the description of “limit”
- [cosmetic] “company_fr_competitors” reworded the description of “scope”
- [cosmetic] “company_fr_default_score” reworded the description of “identifier”
- [cosmetic] “company_fr_director_mandates” reworded the description of “first_names”
- [cosmetic] “company_fr_director_mandates” reworded the description of “last_name”
- [cosmetic] “company_fr_director_mandates” reworded the description of “limit”
- [cosmetic] “company_fr_director_mandates” reworded the description of “page”
- [cosmetic] “company_fr_e_invoice” reworded the description of “identifier”
- [cosmetic] “company_fr_industrial_risk” reworded the description of “identifier”
- [cosmetic] “company_fr_invoice_check” reworded the description of “identifier”
- [cosmetic] “company_fr_invoice_check” reworded the description of “vat_number”
- [cosmetic] “company_fr_kyb” reworded the description of “domain”
- [cosmetic] “company_fr_kyb” reworded the description of “identifier”
- [cosmetic] “company_fr_kyb_batch” reworded the description of “identifiers”
- [cosmetic] “company_fr_legal_announcements_search” reworded the description of “department”
- [cosmetic] “company_fr_legal_announcements_search” reworded the description of “family_code”
- [cosmetic] “company_fr_legal_announcements_search” reworded the description of “limit”
- [cosmetic] “company_fr_legal_announcements_search” reworded the description of “since”
- [cosmetic] “company_fr_legal_announcements_search” reworded the description of “until”
- [cosmetic] “company_fr_legal_announcements_since” reworded the description of “identifier”
- [cosmetic] “company_fr_legal_announcements_since” reworded the description of “limit”
- [cosmetic] “company_fr_legal_announcements_since” reworded the description of “since”
- [cosmetic] “company_fr_lobbying” reworded the description of “identifier”
- [cosmetic] “company_fr_nearby” reworded the description of “activity_code”
- [cosmetic] “company_fr_nearby” reworded the description of “activity_section”
- [cosmetic] “company_fr_nearby” reworded the description of “latitude”
- [cosmetic] “company_fr_nearby” reworded the description of “limit”
- [cosmetic] “company_fr_nearby” reworded the description of “longitude”
- [cosmetic] “company_fr_nearby” reworded the description of “radius_km”
- [cosmetic] “company_fr_payment_context” reworded the description of “domain”
- [cosmetic] “company_fr_payment_context” reworded the description of “identifier”
- [cosmetic] “company_fr_peers” reworded the description of “identifier”
- [cosmetic] “company_fr_peers” reworded the description of “limit”
- [cosmetic] “company_fr_peers” reworded the description of “scope”
- [cosmetic] “company_fr_prospecting” reworded the description of “activity_code”
- [cosmetic] “company_fr_prospecting” reworded the description of “activity_section”
- [cosmetic] “company_fr_prospecting” reworded the description of “bio”
- [cosmetic] “company_fr_prospecting” reworded the description of “company_category”
- [cosmetic] “company_fr_prospecting” reworded the description of “department”
- [cosmetic] “company_fr_prospecting” reworded the description of “employee_band_code”
- [cosmetic] “company_fr_prospecting” reworded the description of “legal_form_code”
- [cosmetic] “company_fr_prospecting” reworded the description of “limit”
- [cosmetic] “company_fr_prospecting” reworded the description of “page”
- [cosmetic] “company_fr_prospecting” reworded the description of “postal_code”
- [cosmetic] “company_fr_prospecting” reworded the description of “qualiopi”
- [cosmetic] “company_fr_prospecting” reworded the description of “query”
- [cosmetic] “company_fr_prospecting” reworded the description of “region”
- [cosmetic] “company_fr_prospecting” reworded the description of “rge”
- [cosmetic] “company_fr_public_contract_competitors” reworded the description of “identifier”
- [cosmetic] “company_fr_public_contract_competitors” reworded the description of “limit”
- [cosmetic] “company_fr_public_contracts_eu” reworded the description of “identifier”
- [cosmetic] “company_fr_public_contracts_eu” reworded the description of “limit”
- [cosmetic] “company_fr_regulator_alerts” reworded the description of “domain”
- [cosmetic] “company_fr_regulator_alerts” reworded the description of “identifier”
- [cosmetic] “company_fr_regulatory_approvals” reworded the description of “identifier”
- [cosmetic] “company_fr_report” reworded the description of “identifier”
- [cosmetic] “company_fr_report” reworded the description of “language”
- [cosmetic] “company_fr_risk_reading” reworded the description of “identifier”
- [cosmetic] “company_fr_risk_reading” reworded the description of “language”
- [cosmetic] “company_fr_sector_statistics” reworded the description of “activity_code”
- [cosmetic] “company_fr_sector_statistics” reworded the description of “department”
- [cosmetic] “company_fr_sector_statistics” reworded the description of “include_financials”
- [cosmetic] “company_fr_sector_statistics” reworded the description of “region”
- [cosmetic] “company_fr_supplier_verification” reworded the description of “iban”
- [cosmetic] “company_fr_supplier_verification” reworded the description of “identifier”
- [cosmetic] “company_fr_supplier_verification” reworded the description of “vat_number”
- [cosmetic] “compliance_name_screen” reworded the description of “name”
- [cosmetic] “compliance_name_screen” reworded the description of “threshold”
- [cosmetic] “iban_validate” reworded the description of “iban”
- [cosmetic] “procurement_fr_buyer_profile” reworded the description of “buyer”
- [cosmetic] “procurement_fr_buyer_profile” reworded the description of “limit”
- [cosmetic] “procurement_fr_deadlines” reworded the description of “cpv_prefix”
- [cosmetic] “procurement_fr_deadlines” reworded the description of “department”
- [cosmetic] “procurement_fr_deadlines” reworded the description of “limit”
- [cosmetic] “procurement_fr_deadlines” reworded the description of “max_months”
- [cosmetic] “procurement_fr_deadlines” reworded the description of “min_months”
- [cosmetic] “vat_eu_validate” reworded the description of “country_code”
- [cosmetic] “vat_eu_validate” reworded the description of “number”
- [cosmetic] “vat_eu_validate” reworded the description of “vat_number”
- [cosmetic] “describe_api” reworded the description of “endpoint”
- [cosmetic] “search_apis” reworded the description of “category”
- [cosmetic] “search_apis” reworded the description of “country”
- [cosmetic] “search_apis” reworded the description of “max_price”
- [cosmetic] “search_apis” reworded the description of “query”

## MCP tools (59)

### `search_apis` (~175 tokens)

Search HelpMyAgent APIs

Find published HelpMyAgent capabilities matching a natural-language task or intent without executing or charging for a paid call. Returns matching endpoint descriptors with pricing, coverage, usage guidance and documentation. Optional category, country and max_price filters narrow the catalogue search.

Input parameters:

- `category` (string): Optional exact published category slug; when supplied, only APIs in that category are considered.
- `country` (string): Optional ISO 3166-1 alpha-2 country code, for example FR; matching is case-insensitive and restricts results to APIs declaring that coverage.
- `max_price` (number): Optional inclusive maximum advertised unit price per call; APIs priced above this value are excluded.
- `query` (string, required): Describe the desired outcome or agent task in natural language; matching uses endpoint names, descriptions, tags, usage guidance and example queries.

Output parameters:

- `apis` (array): Matching API descriptors including endpoint, pricing, coverage, usage guidance and documentation links.
- `count` (integer): Number of published APIs matching the supplied discovery criteria.

### `describe_api` (~76 tokens)

Describe a HelpMyAgent API

Inspect metadata for one published HelpMyAgent endpoint without executing or charging for it. Returns the exact method, executable URL, input/output schemas, price, coverage, provenance, examples and documentation for a canonical endpoint slug.

Input parameters:

- `endpoint` (string, required): Canonical published HelpMyAgent endpoint slug. Accepted values are restricted to the live published catalogue.

### `list_categories` (~52 tokens)

List HelpMyAgent API categories

List public HelpMyAgent API categories and the number of published endpoints in each category without executing or charging for an API call. Returns category slugs, names, endpoint counts and documentation links. This tool takes no arguments.

Output parameters:

- `categories` (array): Published HelpMyAgent API categories with endpoint counts and documentation links.

### `company_fr_aids` (~309 tokens)

French Company Public Funding

Finds and ranks French public funding programs potentially relevant to a company based on its profile, location and project. Eligibility results are indicative and do not constitute an official eligibility decision.
Use when: You need to find and rank French public funding schemes that may fit a company profile, territory and optional project. You need explainable matching reasons and known/unknown eligibility criteria before manually reviewing an aid program.
Avoid when: You need an official eligibility decision, approval decision or automatic grant application. You need funding programs unrelated to the public Aides-entreprises dataset used by this endpoint.
Limitations: potentially_eligible means only that automatically verifiable criteria show no known incompatibility; detailed conditions must still be checked. Some workforce, company-age, size-text and fine-grained geographic criteria can remain unknown, and very local schemes can be omitted when exact geographic matching is not possible.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET
- `limit` (integer): Maximum number of ranked aid schemes to return
- `project` (string): Optional project context used to rank matching public aid schemes

Output parameters:

- `aids` (array): Ranked public funding schemes returned by the endpoint.
- `company_status` (string|null): Current public administrative company status when available.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `matching_context` (object): Structured value returned for “matching context” as defined by this API contract.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `returned_count` (integer): Number of records included in this response.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `source_total_count` (integer): Structured value returned for “source total count” as defined by this API contract.
- `total_candidates` (integer): Structured value returned for “total candidates” as defined by this API contract.
- `truncated` (boolean): Whether additional matching records existed beyond the returned result limit.

### `company_fr_benchmark` (~323 tokens)

Benchmark a French company against public peers

Benchmarks a company against public peers using available revenue, net income, growth and margin metrics.
Use when: Benchmarks a company against public peers using available revenue, net income, growth and margin metrics. You need to benchmark one French company against automatically selected public peers. You want available revenue, net-income, growth and margin comparisons with peer context.
Avoid when: You already have a fixed set of 2 to 5 companies to compare; use company/fr/compare. You only need the comparable-company list without metrics; use company/fr/peers.
Limitations: Benchmark quality depends on public financial data being available for the target and selected peers. The peer sample is an administrative/public-data comparison set, not an official industry benchmark.
Price: 0.040 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): French company identifier: 9-digit SIREN or 14-digit SIRET.
- `peer_limit` (integer): Maximum number of comparable peer companies used by the benchmark. (minimum 2; maximum 10; default 5).
- `scope` (string): Geographic comparison scope controlling whether candidates are selected by department, region or all of France. (default region; allowed values: department, region, france).

Output parameters:

- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `metrics` (object): Structured value returned for “metrics” as defined by this API contract.
- `name`: Publicly available company, person, buyer or record name for this result.
- `peer_count` (integer): Structured value returned for “peer count” as defined by this API contract.
- `peers` (array): Structured value returned for “peers” as defined by this API contract.
- `scope` (string): Structured value returned for “scope” as defined by this API contract.
- `siren`: Normalized 9-digit French SIREN when available.

### `company_fr_certifications` (~252 tokens)

French Company Certifications

Aggregates and normalizes public certifications and qualifications available for a French company, including RGE, organic certification and Qualiopi.
Use when: You need public RGE, organic/Bio or Qualiopi certifications and qualifications linked to a French company. You need one normalized response combining the supported public certification sources.
Avoid when: You need an exhaustive registry of every possible certification, private label or ISO certification held by the company. You need to infer a certification that is not explicitly present in one of the supported public sources.
Limitations: Coverage is limited to the RGE, Agence Bio and Qualiopi public datasets used by this endpoint. A temporarily unavailable source can make the result partial, and source validity/status fields remain authoritative.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET

Output parameters:

- `certifications` (array): Normalized public certification records returned by the endpoint.
- `certifications_count` (integer): Structured value returned for “certifications count” as defined by this API contract.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `sources` (array): Public data sources used or checked for this result.

### `company_fr_changes` (~282 tokens)

French Company Changes

Returns explicit historized Sirene change flags for a French legal unit, with the normalized state that became effective on each change date.
Use when: You need explainable administrative changes recorded in historized Sirene periods for one company.
Avoid when: You need BODACC legal notices; use company/fr/events or company/fr/legal-announcements-search.
Limitations: Only change flags explicitly provided by Sirene are returned; business events are not inferred. Sirene exposes one change indicator for the three usual-denomination fields; when it changes, the post-change values of all three fields are returned.
Price: 0.015 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET
- `limit` (integer): Maximum changes to return, up to 100
- `offset` (integer): Zero-based offset within the filtered change list; use next_offset to continue
- `since` (string): Optional inclusive change start date
- `until` (string): Optional inclusive change end date

Output parameters:

- `changes` (array): Structured value returned for “changes” as defined by this API contract.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `limit` (integer): Structured value returned for “limit” as defined by this API contract.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `next_offset` (integer|null): Structured value returned for “next offset” as defined by this API contract.
- `offset` (integer): Structured value returned for “offset” as defined by this API contract.
- `returned_count` (integer): Number of records included in this response.
- `since` (string|null): Structured value returned for “since” as defined by this API contract.
- `siren` (string): Normalized 9-digit French SIREN when available.
- `total_count` (integer): Total number of matching records reported by the source or endpoint.
- `truncated` (boolean): Whether additional matching records existed beyond the returned result limit.
- `until` (string|null): Structured value returned for “until” as defined by this API contract.

### `company_fr_closures` (~280 tokens)

French Company Closures

Lists French legal units entering a closed Sirene administrative period during a requested date window, while preserving their current status if later reactivated.
Use when: You need French legal units whose Sirene administrative status changed to closed during a date window.
Avoid when: You need BODACC deregistration notices rather than Sirene administrative cessation; use company/fr/events.
Limitations: A Sirene administrative cessation is not equivalent to insolvency, liquidation or a BODACC deregistration notice. A legal unit may later be reactivated. A cursor is bound to its date-window query and should only be reused to continue that same query.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `cursor` (string): Opaque Sirene cursor from next_cursor; omit it on the first call
- `limit` (integer): Maximum results to return, up to 100
- `since` (string): Inclusive start date; defaults to a 7-day window
- `until` (string): Inclusive end date; defaults to today

Output parameters:

- `closures` (array): Structured value returned for “closures” as defined by this API contract.
- `cursor` (string): Structured value returned for “cursor” as defined by this API contract.
- `limit` (integer): Structured value returned for “limit” as defined by this API contract.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `next_cursor` (string|null): Structured value returned for “next cursor” as defined by this API contract.
- `returned_count` (integer): Number of records included in this response.
- `since` (string): Structured value returned for “since” as defined by this API contract.
- `total_count` (integer): Total number of matching records reported by the source or endpoint.
- `truncated` (boolean): Whether additional matching records existed beyond the returned result limit.
- `until` (string): Structured value returned for “until” as defined by this API contract.

### `company_fr_compare` (~281 tokens)

Compare French companies

Compares 2 to 5 French companies across public administrative, financial and legal-risk fields without producing a global winner.
Use when: Compares 2 to 5 French companies across public administrative, financial and legal-risk fields without producing a global winner. You already know 2 to 5 French company identifiers and want a side-by-side public-data comparison. You need comparable administrative, financial and legal-risk fields without declaring a global winner.
Avoid when: You need an automatically selected peer set and relative metrics; use company/fr/benchmark. You need details for only one company; use the relevant single-company endpoint.
Limitations: Comparability depends on which public fields are available for every supplied company. Missing public financial data can make some cross-company comparisons incomplete.
Price: 0.030 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifiers` (array, required): List of French company identifiers to process; each item must be a 9-digit SIREN or 14-digit SIRET. (at least 2 items; at most 5 items).

Output parameters:

- `companies` (array): Structured company records returned by the endpoint.
- `comparability` (object): Structured value returned for “comparability” as defined by this API contract.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `rankings` (object): Structured value returned for “rankings” as defined by this API contract.

### `company_fr_compliance` (~300 tokens)

French Company Compliance Checks

Checks a French company against supported public alert and sanctions sources and adds a structured REGAFI registration summary. The absence of a match must not be interpreted as a guarantee of compliance.
Use when: You need to check a French company against the supported public AMF alert and national asset-freeze sources. You need a structured REGAFI registration summary together with public alert and sanctions checks.
Avoid when: You need a complete AML/KYC decision, beneficial-owner screening or a legal guarantee of compliance. You need company insolvency or deregistration risk rather than sanctions/alert screening; use company/fr/risk.
Limitations: NO_PUBLIC_ALERT_FOUND means only that no match was found in the checked public sources; it is not a compliance guarantee. Matches without a shared administrative identifier can be inferred and are explicitly marked with confidence; an input domain is checked as a separate subject.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `domain` (string): Optional domain to check separately; it is not considered officially associated with the company
- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET

Output parameters:

- `checked_at` (string): UTC timestamp at which HelpMyAgent performed the check.
- `checks` (array): Structured value returned for “checks” as defined by this API contract.
- `company_status` (string|null): Current public administrative company status when available.
- `domain` (string|null): Structured value returned for “domain” as defined by this API contract.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `matches` (array): Candidate public-list or source matches returned by the endpoint.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `regulatory` (object): Structured value returned for “regulatory” as defined by this API contract.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `status` (string): Normalized endpoint or source status. (allowed values: PUBLIC_ALERT_FOUND, NO_PUBLIC_ALERT_FOUND, INCOMPLETE, COMPANY_NOT_FOUND).

### `company_fr_default_score` (~265 tokens)

Explainable public default-risk indicator

Returns a deterministic, explainable HelpMyAgent public-data default-risk indicator. It is not an official credit score.
Use when: Returns a deterministic, explainable HelpMyAgent public-data default-risk indicator. It is not an official credit score. You need one deterministic, explainable public-data default-risk indicator for workflow triage. You want the component contributions and confidence rather than an opaque score.
Avoid when: You only need insolvency, deregistration or legal-event risk; use company/fr/risk. You need an official credit rating, lending decision or regulated probability of default.
Limitations: This is a HelpMyAgent indicator derived from available public data, not an official credit score. Missing source data reduces the evidence available to the indicator and is reflected in confidence/coverage fields.
Price: 0.075 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): French company identifier: 9-digit SIREN or 14-digit SIRET.

Output parameters:

- `components` (array): Structured value returned for “components” as defined by this API contract.
- `confidence` (string): Confidence indicator associated with an inferred or derived result.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable.
- `known_weight_percent`: Structured value returned for “known weight percent” as defined by this API contract.
- `level` (string): Structured value returned for “level” as defined by this API contract.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `name`: Publicly available company, person, buyer or record name for this result.
- `score`: Normalized score produced by the endpoint; interpretation is defined by the tool description and limitations.
- `siren`: Normalized 9-digit French SIREN when available.

### `company_fr_director_mandates` (~332 tokens)

French director mandates

Searches public French company director mandates by name. Name matching can include homonyms and does not prove identity.
Use when: Searches public French company director mandates by name. Name matching can include homonyms and does not prove identity. You know a director name and want public French company mandates associated with that name. You need candidate company links before manually resolving a person’s identity.
Avoid when: You already know the company and need its current listed directors; use company/fr/directors. You need identity proof, beneficial ownership or personal contact information.
Limitations: Name-based matching can include homonyms and does not prove that records refer to the same natural person. Returned mandates depend on the public company records available to the source.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `first_names` (string): Optional first name or given names used to narrow director-mandate matches.
- `last_name` (string, required): Director family name to search in public French company mandates; name matching can include homonyms. (minimum length 2).
- `limit` (integer): Maximum number of records returned by this call. (minimum 1; maximum 25; default 25).
- `page` (integer): One-based result page number. (minimum 1; default 1).

Output parameters:

- `first_names`: Structured value returned for “first names” as defined by this API contract.
- `last_name` (string): Structured value returned for “last name” as defined by this API contract.
- `limit` (integer): Structured value returned for “limit” as defined by this API contract.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `mandates` (array): Structured value returned for “mandates” as defined by this API contract.
- `page` (integer): Structured value returned for “page” as defined by this API contract.
- `returned_mandates` (integer): Structured value returned for “returned mandates” as defined by this API contract.
- `total_companies` (integer): Structured value returned for “total companies” as defined by this API contract.

### `company_fr_directors` (~220 tokens)

French Company Directors

Returns publicly listed directors and legal representatives of a French company from a SIREN or SIRET.
Use when: You need the publicly listed directors or legal representatives of a French company. You need normalized names, roles and available public identity fields for company leadership.
Avoid when: You need beneficial owners or shareholder ownership information; this endpoint does not provide an ownership register. You need personal contact details or non-public information about directors.
Limitations: Only directors and representatives exposed by the public company source are returned. Some person or role fields can be missing or incomplete in the source.
Price: 0.005 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET

Output parameters:

- `directors` (array): Publicly listed directors or legal representatives returned by the endpoint.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `siren` (string|null): Normalized 9-digit French SIREN when available.

### `company_fr_e_invoice` (~252 tokens)

French E-Invoice Preparation

Prepares public company identifiers and a category-based reference schedule for French e-invoicing workflows.
Use when: Prepare public identity fields for a French electronic-invoicing workflow. You need public company identifiers and a category-based reference schedule for a French e-invoicing workflow. You want headquarters SIRET, VAT number and indicative receiving/issuing obligation dates together.
Avoid when: You are checking identifiers already printed on a supplier invoice; use company/fr/invoice-check. You only need the company’s current public profile; use company/fr/profile.
Limitations: The schedule is derived from public company-category information and the implemented reference rules. It does not confirm enrollment with a specific invoicing platform or guarantee operational readiness.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): French company identifier: 9-digit SIREN or 14-digit SIRET.

Output parameters:

- `company_category` (string|null): Structured value returned for “company category” as defined by this API contract.
- `establishment_scope` (string): Structured value returned for “establishment scope” as defined by this API contract.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `headquarters_address` (string|null): Structured value returned for “headquarters address” as defined by this API contract.
- `headquarters_siret` (string|null): Structured value returned for “headquarters siret” as defined by this API contract.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `issuing_obligation_from` (string|null): Structured value returned for “issuing obligation from” as defined by this API contract.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `prepared_at` (string): Structured value returned for “prepared at” as defined by this API contract.
- `receiving_obligation_from` (string|null): Structured value returned for “receiving obligation from” as defined by this API contract.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `vat_number` (string|null): Structured value returned for “vat number” as defined by this API contract.

### `company_fr_establishments` (~252 tokens)

French Company Establishments

Returns cursor-paginated public establishments attached to a French company from the official Sirene source, including status, activity and address.
Use when: You need the public establishments attached to a French SIREN or SIRET.
Avoid when: You only need the company headquarters or administrative profile; use company/fr/profile.
Limitations: Results reflect public establishments exposed by the official Sirene API; restricted non-diffusible data is not returned. A cursor is bound to its search context and should only be reused to continue the same query.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `cursor` (string): Opaque Sirene cursor from next_cursor; omit it on the first call
- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET
- `limit` (integer): Maximum establishments to return, up to 100

Output parameters:

- `cursor` (string): Structured value returned for “cursor” as defined by this API contract.
- `establishments` (array): Structured value returned for “establishments” as defined by this API contract.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `limit` (integer): Structured value returned for “limit” as defined by this API contract.
- `next_cursor` (string|null): Structured value returned for “next cursor” as defined by this API contract.
- `returned_count` (integer): Number of records included in this response.
- `siren` (string): Normalized 9-digit French SIREN when available.
- `total_count` (integer): Total number of matching records reported by the source or endpoint.
- `truncated` (boolean): Whether additional matching records existed beyond the returned result limit.

### `company_fr_events` (~278 tokens)

French Company Events

Returns the latest normalized public BODACC events for a French company from a SIREN or SIRET.
Use when: You need recent normalized BODACC events for a French company, such as filings, modifications, collective proceedings or deregistrations. You need an event timeline filtered from an optional publication date.
Avoid when: You need an interpreted legal-risk level rather than raw normalized events; use company/fr/risk. You only need current administrative profile fields; use company/fr/profile.
Limitations: The result reflects BODACC records available through the public dataset and the requested limit/date filter. Normalized events are factual source records and do not constitute legal advice or a risk score.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET
- `limit` (integer): Maximum number of normalized BODACC events to return
- `since` (string): Minimum included BODACC publication date in YYYY-MM-DD format

Output parameters:

- `events` (array): Normalized public events returned by the endpoint.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `latest_event` (object|null): Structured value returned for “latest event” as defined by this API contract.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `returned_count` (integer): Number of records included in this response.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `total_count` (integer): Total number of matching records reported by the source or endpoint.
- `truncated` (boolean): Whether additional matching records existed beyond the returned result limit.

### `company_fr_financials` (~247 tokens)

French Company Financials

Returns available public financial data for a French company from a SIREN or SIRET, including revenue and net income when available.
Use when: You need publicly available revenue or net-income figures for a French company. You need a normalized multi-year financial history with simple revenue-growth and net-margin calculations when data is available.
Avoid when: You need real-time management accounts, bank data, a company valuation or a credit score. You only need administrative identity or status; use company/fr/profile or company/fr/verify.
Limitations: Financial years are returned only when the public company source exposes filed financial data. Missing or confidential accounts can produce incomplete histories; this service is not a credit assessment or audit opinion.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET

Output parameters:

- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `financials` (array): Normalized public financial-year records returned by the endpoint.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `summary` (object): Compact derived summary of the returned records.

### `company_fr_history` (~203 tokens)

French Company Sirene History

Returns the historized Sirene periods of a French legal unit, including status, name, legal form, activity, headquarters NIC and explicit change flags.
Use when: You need the official Sirene period history for a French legal unit.
Avoid when: You need a BODACC event timeline; use company/fr/events.
Limitations: History reflects Sirene historized variables and should not be interpreted as a complete legal or commercial event history.
Price: 0.015 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET; a SIRET is normalized to its SIREN

Output parameters:

- `current` (object|null): Structured value returned for “current” as defined by this API contract.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `periods` (array): Structured value returned for “periods” as defined by this API contract.
- `periods_count` (integer): Structured value returned for “periods count” as defined by this API contract.
- `siren` (string): Normalized 9-digit French SIREN when available.

### `company_fr_industrial_risk` (~204 tokens)

French Industrial Installation Risk

Finds public ICPE, Seveso and IED installation signals across the company establishments available from SIRENE, with explicit coverage indicators.
Use when: Find public ICPE, Seveso and IED installation signals across the known establishments of a French company.
Avoid when: You only need the company establishment list; use company/fr/establishments.
Limitations: Coverage is explicit and can be partial for very large companies or when public sources are unavailable.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): French company identifier: 9-digit SIREN or 14-digit SIRET.

Output parameters:

- `checked_at` (string): UTC timestamp at which HelpMyAgent performed the check.
- `communes_scanned` (integer): Structured value returned for “communes scanned” as defined by this API contract.
- `communes_total` (integer): Structured value returned for “communes total” as defined by this API contract.
- `coverage_complete` (boolean): Whether the checked public-source coverage was sufficient for the endpoint’s stated scope.
- `establishments_scanned` (integer): Structured value returned for “establishments scanned” as defined by this API contract.
- `establishments_total` (integer|null): Structured value returned for “establishments total” as defined by this API contract.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `headquarters_commune_code` (string|null): Structured value returned for “headquarters commune code” as defined by this API contract.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `installation_count` (integer|null): Structured value returned for “installation count” as defined by this API contract.
- `installations` (array): Structured value returned for “installations” as defined by this API contract.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `source_status` (string): Availability status of the relevant upstream public source. (allowed values: ok, partial, unavailable, not_queried).

### `company_fr_intelligence` (~332 tokens)

French Company Intelligence

Aggregates selected existing French company intelligence services into a single call, with selectable sections and tolerance for temporarily unavailable sources.
Use when: You need several existing French Company intelligence sections in one agent-ready call. You want to select a combination of profile, directors, financials, events, risk, certifications, public contracts, compliance, aids, signals or opportunities. You need the former public-data KYB bundle by requesting profile, directors, financials, risk and compliance together.
Avoid when: You need only one narrow datum and want the smallest, most specific response; call the dedicated endpoint directly. You require every requested section to be available; this aggregator is designed to tolerate temporarily unavailable sources and report partial coverage.
Limitations: This is an aggregator of existing HelpMyAgent Company services and does not create an independent data source or additional factual coverage. Requested sections can be reported unavailable when an underlying public source or service is temporarily unavailable.
Price: 0.050 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `domain` (string): Optional domain used by the compliance section; it is not treated as an officially verified company domain.
- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET
- `include` (array): Optional list of existing Company sections to aggregate in the response

Output parameters:

- `checked_at` (string): UTC timestamp at which HelpMyAgent performed the check.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `sections` (object): Named result sections produced by this aggregator.
- `sections_available` (array): Structured value returned for “sections available” as defined by this API contract.
- `sections_requested` (array): Structured value returned for “sections requested” as defined by this API contract.
- `sections_unavailable` (array): Structured value returned for “sections unavailable” as defined by this API contract.
- `siren` (string|null): Normalized 9-digit French SIREN when available.

### `company_fr_invoice_check` (~252 tokens)

French Invoice Validation

Validates a French company identifier, optional EU VAT number and optional structured invoice fields including supplier name, date and amount arithmetic.
Use when: Validate identifiers and basic structural consistency of a French supplier invoice.
Avoid when: You only need the e-invoicing obligation schedule; use company/fr/e-invoice. You need to validate only an EU VAT number; use vat/eu/validate.
Limitations: The endpoint checks supplied structured fields; it does not authenticate a document or prove that goods, services or payment are real.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): French company identifier: 9-digit SIREN or 14-digit SIRET.
- `invoice` (object): Optional value for “invoice” as defined by this API contract.
- `vat_number` (string): Optional or required VAT identifier used by this validation or consistency check.

Output parameters:

- `checked_at` (string): UTC timestamp at which HelpMyAgent performed the check.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `expected_vat_number` (string|null): Structured value returned for “expected vat number” as defined by this API contract.
- `format_match` (boolean|null): Structured value returned for “format match” as defined by this API contract.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `invoice_validation` (object): Structured value returned for “invoice validation” as defined by this API contract.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `supplied_vat_number` (string|null): Structured value returned for “supplied vat number” as defined by this API contract.
- `verdict` (string): Normalized endpoint conclusion derived from the checked public data.
- `vies_name` (string|null): Structured value returned for “vies name” as defined by this API contract.
- `vies_status` (string): Structured value returned for “vies status” as defined by this API contract.
- `vies_valid` (boolean|null): Structured value returned for “vies valid” as defined by this API contract.

### `company_fr_kyb_batch` (~288 tokens)

French Company KYB Batch

Runs the existing public-data KYB dossier for 2 to 10 French company identifiers.
Use when: Screen a batch of French suppliers with the public-data KYB dossier. You need the existing public-data KYB dossier for several French company identifiers in one call. You are screening a small supplier batch and need per-company success/failure results.
Avoid when: You have only one company; use company/fr/intelligence with the KYB sections profile, directors, financials, risk and compliance. You specifically need VAT or IBAN consistency checks during supplier onboarding; use company/fr/supplier-verification.
Limitations: Each item inherits the source coverage of the corresponding company/fr/intelligence sections. One company can fail or be partial without implying the same status for the other batch items.
Price: 0.100 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifiers` (array, required): List of French company identifiers to process; each item must be a 9-digit SIREN or 14-digit SIRET. (at least 2 items; at most 10 items).

Output parameters:

- `checked_at` (string): UTC timestamp at which HelpMyAgent performed the check.
- `completed_count` (integer): Structured value returned for “completed count” as defined by this API contract.
- `failed_count` (integer): Structured value returned for “failed count” as defined by this API contract.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `requested_count` (integer): Structured value returned for “requested count” as defined by this API contract.
- `results` (array): Structured result records returned by the endpoint.

### `company_fr_legal_announcements_search` (~333 tokens)

Search French BODACC announcements

Searches BODACC public announcements by family, date window and/or department.
Use when: Searches BODACC public announcements by family, date window and/or department. You need to search BODACC announcements across companies by family, date window and/or department. You are building a broad legal-announcement discovery or monitoring query.
Avoid when: You need the event timeline of one known company; use company/fr/events. You are polling one company from a saved date; use company/fr/events with the since parameter.
Limitations: Results reflect BODACC records matching the supplied filters and the public source’s current coverage. Announcement records are factual source items and do not by themselves constitute legal-risk interpretation.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `department` (string): Optional French department code used to restrict results geographically.
- `family_code` (string): Optional BODACC announcement family code used to restrict legal-announcement results.
- `limit` (integer): Maximum number of records returned by this call. (minimum 1; maximum 100; default 25).
- `since` (string): Earliest publication or event date to include, in YYYY-MM-DD format.
- `until` (string): Latest publication or event date to include, in YYYY-MM-DD format.

Output parameters:

- `announcements` (array): Structured value returned for “announcements” as defined by this API contract.
- `criteria` (object): Structured value returned for “criteria” as defined by this API contract.
- `returned_count` (integer): Number of records included in this response.
- `total_count` (integer): Total number of matching records reported by the source or endpoint.
- `truncated` (boolean): Whether additional matching records existed beyond the returned result limit.

### `company_fr_lobbying` (~246 tokens)

French Lobbying Public Profile

Checks the HATVP public lobbying register by French company identifier and extracts declared topics.
Use when: Find the public lobbying profile declared for a French organization. You need the public HATVP lobbying-register profile associated with a French organization. You want declared lobbying topics, domains or clients when exposed by that public source.
Avoid when: You need ordinary company identity, directors or ownership information; use company/fr/profile or company/fr/directors. You need lobbying information not covered by the French HATVP public register.
Limitations: Coverage is limited to declarations exposed by the HATVP public lobbying dataset. A missing record does not prove that an organization has never undertaken any influence-related activity.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): French company identifier: 9-digit SIREN or 14-digit SIRET.

Output parameters:

- `activity_topics` (array): Structured value returned for “activity topics” as defined by this API contract.
- `checked_at` (string): UTC timestamp at which HelpMyAgent performed the check.
- `clients` (array): Structured value returned for “clients” as defined by this API contract.
- `declared_name` (string|null): Structured value returned for “declared name” as defined by this API contract.
- `domains` (array): Structured value returned for “domains” as defined by this API contract.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `registered` (boolean|null): Structured value returned for “registered” as defined by this API contract.
- `registration_date` (string|null): Structured value returned for “registration date” as defined by this API contract.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `source_json_url` (string|null): Structured value returned for “source json url” as defined by this API contract.
- `source_status` (string): Availability status of the relevant upstream public source. (allowed values: ok, unavailable, not_queried).

### `company_fr_nearby` (~379 tokens)

Nearby French companies

Searches French companies around geographic coordinates using the official public company search geolocation endpoint.
Use when: Searches French companies around geographic coordinates using the official public company search geolocation endpoint. You have geographic coordinates and need French companies within a radius. You want optional NAF activity filtering around a physical location.
Avoid when: You want structured B2B prospecting by region, size, legal form or certifications without coordinates; use company/fr/prospecting. You are searching for a known company by name or identifier; use company/fr/search.
Limitations: Results depend on geocoded establishment data exposed by the public company-search source. A geographic match indicates proximity, not a commercial relationship or service area.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `activity_code` (string): Optional French NAF activity code used to restrict nearby-company results.
- `activity_section` (string): Optional NAF activity section letter used to restrict nearby-company results.
- `latitude` (number, required): Latitude in decimal degrees for the centre of the geographic search. (minimum -90; maximum 90).
- `limit` (integer): Maximum number of records returned by this call. (minimum 1; maximum 25; default 10).
- `longitude` (number, required): Longitude in decimal degrees for the centre of the geographic search. (minimum -180; maximum 180).
- `radius_km` (number): Search radius around the supplied coordinates, expressed in kilometres. (greater than 0; maximum 50; default 5).

Output parameters:

- `activity_code`: Structured value returned for “activity code” as defined by this API contract.
- `activity_section`: Structured value returned for “activity section” as defined by this API contract.
- `companies` (array): Structured company records returned by the endpoint.
- `latitude` (number): Structured value returned for “latitude” as defined by this API contract.
- `longitude` (number): Structured value returned for “longitude” as defined by this API contract.
- `radius_km` (number): Structured value returned for “radius km” as defined by this API contract.
- `returned_count` (integer): Number of records included in this response.
- `total_count` (integer): Total number of matching records reported by the source or endpoint.
- `truncated` (boolean): Whether additional matching records existed beyond the returned result limit.

### `company_fr_new` (~274 tokens)

New French Companies

Lists French legal units created in a requested date window using the official historized Sirene source.
Use when: You need French legal units created during a recent or historical date window.
Avoid when: You need BODACC publication events rather than Sirene creation dates; use company/fr/events or legal-announcements-search.
Limitations: Creation date is the Sirene legal-unit creation date and is not the same as a BODACC publication date. The requested window is limited to 366 days per call. A cursor is bound to its date-window query and should only be reused to continue that same query.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `cursor` (string): Opaque Sirene cursor from next_cursor; omit it on the first call
- `limit` (integer): Maximum results to return, up to 100
- `since` (string): Inclusive start date; defaults to a 7-day window
- `until` (string): Inclusive end date; defaults to today

Output parameters:

- `companies` (array): Structured company records returned by the endpoint.
- `cursor` (string): Structured value returned for “cursor” as defined by this API contract.
- `limit` (integer): Structured value returned for “limit” as defined by this API contract.
- `next_cursor` (string|null): Structured value returned for “next cursor” as defined by this API contract.
- `returned_count` (integer): Number of records included in this response.
- `since` (string): Structured value returned for “since” as defined by this API contract.
- `total_count` (integer): Total number of matching records reported by the source or endpoint.
- `truncated` (boolean): Whether additional matching records existed beyond the returned result limit.
- `until` (string): Structured value returned for “until” as defined by this API contract.

### `company_fr_opportunities` (~291 tokens)

French Company Opportunities

Ranks actionable French public funding and open procurement opportunities for a company using its profile, project context and historical public contracts.
Use when: You need company-specific actionable opportunities combining public aid matching and currently open public tenders. You want opportunities ranked from the company profile, optional project context and historical public-contract evidence.
Avoid when: You need a broad open-tender search without company context; use procurement/fr/search. You need a guarantee of aid eligibility, tender suitability or commercial success.
Limitations: PUBLIC_AID opportunities are produced only when a project is provided and matches the public taxonomy; they remain indicative, not official eligibility decisions. PUBLIC_TENDER matching is intentionally conservative and relies on common CPV codes plus shared business vocabulary with historical awarded contracts; source coverage can be partial.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET
- `limit` (integer): Maximum number of ranked opportunities to return
- `project` (string): Optional project context used for public-aid and opportunity matching

Output parameters:

- `company_status` (string|null): Current public administrative company status when available.
- `coverage` (array): Coverage information describing which underlying services or sources were available.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `opportunities` (array): Ranked public-data opportunities returned by the endpoint.
- `project` (string|null): Structured value returned for “project” as defined by this API contract.
- `returned_count` (integer): Number of records included in this response.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `total_candidates` (integer): Structured value returned for “total candidates” as defined by this API contract.
- `truncated` (boolean): Whether additional matching records existed beyond the returned result limit.

### `company_fr_payment_context` (~283 tokens)

Payment context for a French company

Returns structured public counterparty context before an automated B2B payment. It never approves or recommends a payment.
Use when: Returns structured public counterparty context before an automated B2B payment. It never approves or recommends a payment. You need compact public counterparty context immediately before an automated B2B payment. You want company status, legal-risk and compliance signals together without a full KYB dossier.
Avoid when: You only need existence or administrative status; use company/fr/verify. You need a broader multi-section company dossier; use company/fr/intelligence.
Limitations: This endpoint supplies decision context but never approves, blocks or recommends a payment. It does not verify bank-account ownership, invoice authenticity or private payment behavior.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `domain` (string): Optional domain supplied as additional counterparty context; it is checked separately and is not treated as proof of company ownership.
- `identifier` (string, required): French company identifier: 9-digit SIREN or 14-digit SIRET.

Output parameters:

- `checked_at` (string): UTC timestamp at which HelpMyAgent performed the check.
- `collective_procedure_events` (integer|null): Structured value returned for “collective procedure events” as defined by this API contract.
- `company_status`: Current public administrative company status when available.
- `compliance_status` (string): Structured value returned for “compliance status” as defined by this API contract.
- `coverage` (array): Coverage information describing which underlying services or sources were available.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable.
- `latest_relevant_event`: Structured value returned for “latest relevant event” as defined by this API contract.
- `legal_risk`: Structured value returned for “legal risk” as defined by this API contract.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `name`: Publicly available company, person, buyer or record name for this result.
- `public_alerts_found` (boolean|null): Structured value returned for “public alerts found” as defined by this API contract.
- `radiation_events` (integer|null): Structured value returned for “radiation events” as defined by this API contract.
- `siren`: Normalized 9-digit French SIREN when available.

### `company_fr_peers` (~305 tokens)

Comparable French companies

Finds administratively comparable French companies for later comparison or benchmarking.
Use when: Finds administratively comparable French companies for later comparison or benchmarking. You need administratively comparable French companies selected from activity, size and geographic criteria. You want a peer set that can feed a later benchmark or manual comparison.
Avoid when: You need procurement-specific competitors observed in public-contract awards; use company/fr/public-contract-competitors. You want metrics and relative positioning rather than just a peer set; use company/fr/benchmark.
Limitations: Peer relationships are inferred from public administrative attributes and do not prove economic comparability. The returned peer set depends on source coverage and the selected geographic scope.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): French company identifier: 9-digit SIREN or 14-digit SIRET.
- `limit` (integer): Maximum number of records returned by this call. (minimum 1; maximum 25; default 10).
- `scope` (string): Geographic comparison scope controlling whether candidates are selected by department, region or all of France. (default region; allowed values: department, region, france).

Output parameters:

- `criteria` (object): Structured value returned for “criteria” as defined by this API contract.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `name`: Publicly available company, person, buyer or record name for this result.
- `peers` (array): Structured value returned for “peers” as defined by this API contract.
- `scope` (string): Structured value returned for “scope” as defined by this API contract.
- `siren`: Normalized 9-digit French SIREN when available.

### `company_fr_profile` (~244 tokens)

French Company Profile

Returns the public profile of a French company from a SIREN or SIRET.
Use when: You need a normalized public administrative profile for a French company from its SIREN or SIRET. You need headquarters, activity, legal-form, creation-date, employee-band or establishment-count fields in one response.
Avoid when: You only need a yes/no existence or active-status check; use company/fr/verify. You need directors, financial statements, legal risk or compliance results; use the dedicated endpoint.
Limitations: Some profile fields can be null when the public source does not expose them for the company. This endpoint does not replace the specialized directors, financials, risk or compliance endpoints.
Price: 0.005 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET

Output parameters:

- `activity_code` (string|null): Structured value returned for “activity code” as defined by this API contract.
- `closure_date` (string|null): Structured value returned for “closure date” as defined by this API contract.
- `company_category` (string|null): Structured value returned for “company category” as defined by this API contract.
- `creation_date` (string|null): Structured value returned for “creation date” as defined by this API contract.
- `employee_band_code` (string|null): Structured value returned for “employee band code” as defined by this API contract.
- `employee_band_year` (string|null): Structured value returned for “employee band year” as defined by this API contract.
- `establishments_count` (integer|null): Structured value returned for “establishments count” as defined by this API contract.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `headquarters` (object|null): Structured value returned for “headquarters” as defined by this API contract.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `is_employer` (boolean|null): Structured value returned for “is employer” as defined by this API contract.
- `legal_form_code` (string|null): Structured value returned for “legal form code” as defined by this API contract.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `open_establishments_count` (integer|null): Structured value returned for “open establishments count” as defined by this API contract.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `status` (string|null): Normalized endpoint or source status.

### `company_fr_prospecting` (~531 tokens)

French B2B company prospecting

Searches active French companies using structured public B2B filters such as activity, geography, size and supported certifications.
Use when: Searches active French companies using structured public B2B filters such as activity, geography, size and supported certifications. You need a list of active French companies matching structured B2B criteria such as activity, geography, size or supported certifications. You want prospect candidates before running deeper company checks.
Avoid when: You are looking for one known company by name, SIREN or SIRET; use company/fr/search. You need a radius search around coordinates; use company/fr/nearby.
Limitations: Prospecting coverage follows the public company and certification sources used by the selected filters. A filter match is a discovery signal, not proof of commercial suitability or current willingness to buy.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `activity_code` (string): Optional French NAF activity code used to restrict or classify company results.
- `activity_section` (string): Optional NAF activity section used to restrict company results.
- `bio` (boolean): When true, restrict results to companies found in the supported public organic/Bio certification source.
- `company_category` (string): Optional French company-size category used to restrict prospecting results.
- `department` (string): Optional French department code used to restrict results geographically.
- `employee_band_code` (string): Optional official employee-band code used to restrict company results.
- `legal_form_code` (string): Optional French legal-form code used to restrict company results.
- `limit` (integer): Maximum number of records returned by this call. (minimum 1; maximum 25; default 25).
- `page` (integer): One-based result page number. (minimum 1; default 1).
- `postal_code` (string): Optional French postal code used to narrow results geographically.
- `qualiopi` (boolean): When true, restrict results to companies found in the supported public Qualiopi source.
- `query` (string): Optional company-name or free-text term combined with the structured prospecting filters.
- `region` (string): Optional French region code used to restrict results geographically.
- `rge` (boolean): When true, restrict results to companies with a supported public RGE qualification.

Output parameters:

- `companies` (array): Structured company records returned by the endpoint.
- `filters` (object): Structured value returned for “filters” as defined by this API contract.
- `limit` (integer): Structured value returned for “limit” as defined by this API contract.
- `page` (integer): Structured value returned for “page” as defined by this API contract.
- `returned_count` (integer): Number of records included in this response.
- `total_count` (integer): Total number of matching records reported by the source or endpoint.
- `truncated` (boolean): Whether additional matching records existed beyond the returned result limit.

### `company_fr_public_contract_competitors` (~290 tokens)

Public-contract competitors

Finds companies winning public contracts on CPV segments shared with the target company using DECP public award data.
Use when: Finds companies winning public contracts on CPV segments shared with the target company using DECP public award data. You need companies that win public contracts on CPV segments also observed for the target company. You want procurement-specific competitive signals from DECP award data.
Avoid when: You want general comparable companies based on activity, size and geography; use company/fr/peers. You only need the target company’s own awarded public contracts; use company/fr/public-contracts.
Limitations: Competition is inferred from shared public-contract CPV segments and is not an official competitive relationship. The result only reflects awards covered by the DECP public dataset.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): French company identifier: 9-digit SIREN or 14-digit SIRET.
- `limit` (integer): Maximum number of records returned by this call. (minimum 1; maximum 25; default 10).

Output parameters:

- `competitors` (array): Structured value returned for “competitors” as defined by this API contract.
- `cpv_segments` (array): Structured value returned for “cpv segments” as defined by this API contract.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `name`: Publicly available company, person, buyer or record name for this result.
- `siren`: Normalized 9-digit French SIREN when available.

### `company_fr_public_contracts` (~249 tokens)

French Company Public Contracts

Returns public contracts awarded to a French company from consolidated French public procurement award data.
Use when: You need public contracts already awarded to a French company. You need historical procurement awards, buyers, amounts, CPV codes or execution-location data linked to a company identifier.
Avoid when: You need currently open tenders that a company could bid on; use procurement/fr/search or company/fr/opportunities. You need private-sector contracts or non-public commercial relationships.
Limitations: Coverage depends on the consolidated DECP public award dataset and the holder identifiers available in it. Returned totals and summaries describe the matched public records, not all commercial revenue of the company.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET
- `limit` (integer): Maximum number of awarded public contracts to return

Output parameters:

- `contracts` (array): Normalized public-contract records returned by the endpoint.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `returned_count` (integer): Number of records included in this response.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `summary` (object): Compact derived summary of the returned records.
- `total_count` (integer): Total number of matching records reported by the source or endpoint.
- `truncated` (boolean): Whether additional matching records existed beyond the returned result limit.

### `company_fr_public_contracts_eu` (~296 tokens)

French Company EU Public Contracts

Searches TED notices for EU public-contract awards associated with a French company name or SIREN.
Use when: Find EU public-contract notices won by a French company. You need TED public-contract award notices associated with a French company at EU procurement level. You want publication numbers, buyers, winners, CPV codes and decision dates from the supported TED search.
Avoid when: You need French DECP awarded contracts for the company; use company/fr/public-contracts. You need currently open French BOAMP opportunities; use procurement/fr/search.
Limitations: TED matching can rely on company name and available identifiers, so notices can be missed or require manual disambiguation. The result reflects notices returned by the TED public source and is not a complete statement of all EU business won by the company.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): French company identifier: 9-digit SIREN or 14-digit SIRET.
- `limit` (integer): Maximum number of records returned by this call. (minimum 1; maximum 50; default 20).

Output parameters:

- `checked_at` (string): UTC timestamp at which HelpMyAgent performed the check.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `notices` (array): Structured value returned for “notices” as defined by this API contract.
- `returned_count` (integer|null): Number of records included in this response.
- `search_query` (string|null): Structured value returned for “search query” as defined by this API contract.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `source_status` (string): Availability status of the relevant upstream public source. (allowed values: ok, unavailable, not_queried).

### `company_fr_regulatory_approvals` (~259 tokens)

French Financial Regulatory Approvals

Checks a French company against the public REGAFI register and normalizes matching regulatory records.
Use when: Check whether a French company appears in the public REGAFI register. You need to know whether a French company appears in the public REGAFI register and inspect normalized matching records. You specifically need financial-regulatory registration signals rather than general company compliance.
Avoid when: You want public alerts plus a REGAFI registration summary; use company/fr/compliance. You need general sanctions or asset-freeze screening; use company/fr/compliance.
Limitations: Coverage is limited to the public REGAFI source used by the endpoint. No REGAFI match is not a universal statement that an entity is unregulated in every jurisdiction or activity.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): French company identifier: 9-digit SIREN or 14-digit SIRET.

Output parameters:

- `approval_count` (integer|null): Structured value returned for “approval count” as defined by this API contract.
- `approvals` (array): Structured value returned for “approvals” as defined by this API contract.
- `checked_at` (string): UTC timestamp at which HelpMyAgent performed the check.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `regulated` (boolean|null): Structured value returned for “regulated” as defined by this API contract.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `source_status` (string): Availability status of the relevant upstream public source. (allowed values: ok, unavailable, not_queried).

### `company_fr_report` (~267 tokens)

French Company PDF Report

Generates a simple PDF rendition of selected HelpMyAgent public company intelligence.
Use when: Generate a portable PDF summary for a French company. You need a portable PDF summary of selected HelpMyAgent public company intelligence. You need a human-readable artifact in French or English rather than only structured JSON.
Avoid when: You need structured data for downstream automation; use company/fr/intelligence or a dedicated endpoint. You only need a written risk interpretation; use company/fr/risk-reading.
Limitations: The PDF reflects the public-data sections available when it is generated and does not add independent factual coverage. It is an informational report, not an audit, legal opinion or regulated credit report.
Price: 0.075 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): French company identifier: 9-digit SIREN or 14-digit SIRET.
- `language` (string): Language used for the generated human-readable output. (default fr; allowed values: fr, en).

Output parameters:

- `bytes` (integer): Structured value returned for “bytes” as defined by this API contract.
- `filename` (string): Structured value returned for “filename” as defined by this API contract.
- `generated_at` (string): UTC timestamp at which this derived result was generated.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `language` (string): Structured value returned for “language” as defined by this API contract.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `mime_type` (string): Structured value returned for “mime type” as defined by this API contract.
- `pdf_base64` (string): Structured value returned for “pdf base64” as defined by this API contract.
- `sections` (object): Named result sections produced by this aggregator.
- `sha256` (string): Structured value returned for “sha256” as defined by this API contract.

### `company_fr_risk` (~264 tokens)

French Company Legal Risk

Detects public legal-risk signals for a French company from company status and BODACC notices, including insolvency proceedings and deregistrations. This is not a credit score.
Use when: You need explainable public legal-risk signals for a French company, including insolvency proceedings, deregistrations and administrative closure. You need a normalized low, warning, high or unknown legal-risk level backed by public events.
Avoid when: You need a credit score, probability of default, payment behavior or bank-grade solvency assessment. You need sanctions or regulatory blacklist screening; use company/fr/compliance.
Limitations: The BODACC analysis uses a 10-year lookback and reports when source coverage is insufficient to conclude. This is a public legal-risk signal service, not a credit score or legal opinion.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET

Output parameters:

- `assessment_basis` (string): Structured value returned for “assessment basis” as defined by this API contract.
- `company_status` (string|null): Current public administrative company status when available.
- `coverage_complete` (boolean|null): Whether the checked public-source coverage was sufficient for the endpoint’s stated scope.
- `events` (array): Normalized public events returned by the endpoint.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `latest_event` (object|null): Structured value returned for “latest event” as defined by this API contract.
- `lookback_years` (integer): Structured value returned for “lookback years” as defined by this API contract.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `risk_level` (string|null): Explainable public-data risk level produced by this endpoint; it is not an official credit score. (allowed values: low, warning, high, unknown).
- `signals` (object): Structured value returned for “signals” as defined by this API contract.
- `siren` (string|null): Normalized 9-digit French SIREN when available.

### `company_fr_risk_reading` (~275 tokens)

French Company Risk Reading

Turns existing public risk, legal, financial and signal data into a concise written reading.
Use when: Get a written public-data risk reading for a French company. You need a concise human-readable interpretation of existing public risk, legal, financial and signal data. You want strengths, alerts and evidence summarized in French or English.
Avoid when: You need structured legal-risk events and level only; use company/fr/risk. You need the deterministic public-data default indicator and components; use company/fr/default-score.
Limitations: The narrative is derived from existing HelpMyAgent public-data results and does not create new source evidence. It is informational and must not be treated as a regulated credit or legal decision.
Price: 0.030 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): French company identifier: 9-digit SIREN or 14-digit SIRET.
- `language` (string): Language used for the generated human-readable output. (default fr; allowed values: fr, en).

Output parameters:

- `alerts` (array): Structured value returned for “alerts” as defined by this API contract.
- `confidence` (string|null): Confidence indicator associated with an inferred or derived result.
- `evidence` (object): Structured value returned for “evidence” as defined by this API contract.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `generated_at` (string): UTC timestamp at which this derived result was generated.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `language` (string): Structured value returned for “language” as defined by this API contract.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `narrative` (string): Structured value returned for “narrative” as defined by this API contract.
- `score` (number|null): Normalized score produced by the endpoint; interpretation is defined by the tool description and limitations.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `strengths` (array): Structured value returned for “strengths” as defined by this API contract.
- `verdict` (string): Normalized endpoint conclusion derived from the checked public data.

### `company_fr_search` (~291 tokens)

French Company Search

Searches French companies by name, SIREN, SIRET or optional location criteria and returns structured matching company records.
Use when: You need to find a French company or establishment from a name, legal name, SIREN or SIRET. You need candidate company identifiers before calling a more specialized Company endpoint.
Avoid when: You already have an exact SIREN or SIRET and only need to verify existence or administrative status; use company/fr/verify. You need detailed profile, financial, legal-risk or compliance data; use the specialized endpoint or company/fr/intelligence.
Limitations: Matching quality and result ordering depend on the public company-search source and the ambiguity of the query. The response is a search result set, not a complete company dossier.
Price: 0.002 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `limit` (integer): Maximum number of matching companies to return
- `postal_code` (string): Optional French postal code used to narrow the search
- `query` (string, required): Company name, legal name, SIREN or SIRET to search for

Output parameters:

- `results` (array): Structured result records returned by the endpoint.

### `company_fr_sector_statistics` (~325 tokens)

French Company Sector Statistics

Returns the source-reported active-company count for a French NAF activity plus explicit descriptive samples for age, workforce bands and optional financials; large counts can be capped at 10,000 by the source.
Use when: Measure the source-reported active-company count for a French NAF activity and obtain descriptive sample statistics.
Avoid when: You need an official INSEE statistical publication rather than statistics computed from company records.
Limitations: The Recherche d'entreprises search engine caps large total-result counts at 10,000. When total_active is 10000, total_active_is_exact is false and the true count is at least 10,000. Age, workforce-band and financial distributions remain explicitly sampled. When the total count is capped, sample_coverage_percent is an upper bound.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `activity_code` (string, required): French NAF activity code to summarize, in the form 00.00A.
- `department` (string): Optional French department code used to restrict results geographically.
- `include_financials` (boolean): When true, include the supported public financial sample in the sector statistics. (default false).
- `region` (string): Optional French region code used to restrict results geographically.

Output parameters:

- `activity_code` (string): Structured value returned for “activity code” as defined by this API contract.
- `age_years` (object): Structured value returned for “age years” as defined by this API contract.
- `department` (string|null): Structured value returned for “department” as defined by this API contract.
- `employee_band_distribution` (array): Structured value returned for “employee band distribution” as defined by this API contract.
- `financial_sample_count` (integer): Structured value returned for “financial sample count” as defined by this API contract.
- `generated_at` (string): UTC timestamp at which this derived result was generated.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `median_net_income` (number|integer|null): Structured value returned for “median net income” as defined by this API contract.
- `median_revenue` (number|integer|null): Structured value returned for “median revenue” as defined by this API contract.
- `region` (string|null): Structured value returned for “region” as defined by this API contract.
- `sample_coverage_percent` (number): Structured value returned for “sample coverage percent” as defined by this API contract.
- `sample_limit` (integer): Structured value returned for “sample limit” as defined by this API contract.
- `sampled_count` (integer): Structured value returned for “sampled count” as defined by this API contract.
- `total_active` (integer): Structured value returned for “total active” as defined by this API contract.
- `total_active_is_exact` (boolean): Structured value returned for “total active is exact” as defined by this API contract.

### `company_fr_signals` (~268 tokens)

French Company Signals

Detects explainable business signals from available French company data, including closure, insolvency, revenue changes, new filings, public contracts and certifications.
Use when: You need explainable business signals derived from existing public Company data rather than raw records from one source. You want to detect supported signals such as closure, insolvency, revenue change, new financial filings, public contracts or certifications.
Avoid when: You need the underlying raw financial, BODACC, contract or certification records; call the specialized endpoint instead. You need continuous monitoring or push alerts; this endpoint evaluates signals at request time and is not a subscription service.
Limitations: Only the signal families explicitly implemented by the endpoint are evaluated; it is not a general predictive business-risk model. Coverage can be partial when one of the underlying public-data services is unavailable.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET

Output parameters:

- `checked_at` (string): UTC timestamp at which HelpMyAgent performed the check.
- `coverage` (array): Coverage information describing which underlying services or sources were available.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `lookback_days` (integer): Structured value returned for “lookback days” as defined by this API contract.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `signals` (array): Structured value returned for “signals” as defined by this API contract.
- `signals_count` (integer): Structured value returned for “signals count” as defined by this API contract.
- `siren` (string|null): Normalized 9-digit French SIREN when available.

### `company_fr_successions` (~275 tokens)

French Establishment Successions

Returns official Sirene predecessor and successor links for a French establishment, with effective date, headquarters-transfer flag and economic-continuity flag.
Use when: You need official predecessor or successor establishment links for a French SIRET.
Avoid when: You only need the current establishments of a company; use company/fr/establishments.
Limitations: Succession links are declaration-based and INSEE explicitly states that not every real-world succession is necessarily known. Predecessor and successor cursors are independent and must only be reused for the same SIRET and direction.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `limit` (integer): Maximum predecessor and successor links per direction, up to 100
- `predecessors_cursor` (string): Opaque cursor returned by predecessors_next_cursor; omit on the first call
- `siret` (string, required): 14-digit French SIRET
- `successors_cursor` (string): Opaque cursor returned by successors_next_cursor; omit on the first call

Output parameters:

- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `predecessors` (array): Structured value returned for “predecessors” as defined by this API contract.
- `predecessors_count` (integer): Structured value returned for “predecessors count” as defined by this API contract.
- `predecessors_cursor` (string): Structured value returned for “predecessors cursor” as defined by this API contract.
- `predecessors_next_cursor` (string|null): Structured value returned for “predecessors next cursor” as defined by this API contract.
- `predecessors_returned_count` (integer): Structured value returned for “predecessors returned count” as defined by this API contract.
- `predecessors_truncated` (boolean): Structured value returned for “predecessors truncated” as defined by this API contract.
- `siren` (string): Normalized 9-digit French SIREN when available.
- `siret` (string): Normalized 14-digit French SIRET when available.
- `successors` (array): Structured value returned for “successors” as defined by this API contract.
- `successors_count` (integer): Structured value returned for “successors count” as defined by this API contract.
- `successors_cursor` (string): Structured value returned for “successors cursor” as defined by this API contract.
- `successors_next_cursor` (string|null): Structured value returned for “successors next cursor” as defined by this API contract.
- `successors_returned_count` (integer): Structured value returned for “successors returned count” as defined by this API contract.
- `successors_truncated` (boolean): Structured value returned for “successors truncated” as defined by this API contract.

### `company_fr_supplier_verification` (~295 tokens)

French Supplier Verification

Combines public company, compliance and optional VAT/IBAN consistency checks into a supplier review result.
Use when: Review a French supplier before onboarding or payment. You need a compact pre-onboarding or pre-payment review of a French supplier using public company/compliance data plus optional VAT and IBAN checks. You want one normalized supplier verdict while retaining the individual check results.
Avoid when: You need a broader multi-section company dossier; use company/fr/intelligence. You only need to compare invoice identifiers and VAT information; use company/fr/invoice-check.
Limitations: IBAN validation is structural and does not prove bank-account ownership by the supplier. The result is public-data decision support, not a guarantee that a supplier or payment is fraud-free.
Price: 0.050 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `iban` (string): IBAN supplied for structural validation or supplier consistency checks.
- `identifier` (string, required): French company identifier: 9-digit SIREN or 14-digit SIRET.
- `vat_number` (string): Optional or required VAT identifier used by this validation or consistency check.

Output parameters:

- `checked_at` (string): UTC timestamp at which HelpMyAgent performed the check.
- `checks` (object): Structured value returned for “checks” as defined by this API contract.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `verdict` (string): Normalized endpoint conclusion derived from the checked public data.

### `company_fr_verify` (~248 tokens)

French Company Verification

Verifies the existence and current status of a French company or establishment from a SIREN or SIRET.
Use when: You have a French SIREN or SIRET and need to confirm that the company or establishment exists in the public source. You need its current administrative active/closed status before another automated step.
Avoid when: You only have a company name and need to discover its identifier; use company/fr/search. You need directors, financials, legal risk or compliance checks; use the corresponding specialized endpoint.
Limitations: This verifies public administrative existence and status only; it is not KYC, identity assurance or beneficial-owner verification. Returned fields depend on what the public company source exposes for the identifier.
Price: 0.005 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `identifier` (string, required): 9-digit SIREN or 14-digit SIRET

Output parameters:

- `active` (boolean|null): Current public administrative active status when available.
- `activity_code` (string|null): Structured value returned for “activity code” as defined by this API contract.
- `address` (string|null): Structured value returned for “address” as defined by this API contract.
- `city` (string|null): Structured value returned for “city” as defined by this API contract.
- `exists` (boolean): Whether the requested company or public record was found in the checked source.
- `identifier` (string): Identifier supplied for the request, echoed in normalized form when applicable.
- `identifier_type` (string): Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret).
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `postal_code` (string|null): Structured value returned for “postal code” as defined by this API contract.
- `siren` (string|null): Normalized 9-digit French SIREN when available.
- `siret` (string|null): Normalized 14-digit French SIRET when available.

### `compliance_name_screen` (~307 tokens)

Public Sanctions Name Screen

Screens a name against integrated French, UK and UN public sanctions/freezing lists using explainable fuzzy matching.
Use when: Screen a person or organization name against public sanctions lists. You have a person or organization name and need explainable screening against the supported French, UK and UN public sanctions lists. You need candidate matches with fuzzy-match scores before manual review.
Avoid when: You have a French company identifier and want company-aware public compliance checks; use company/fr/compliance. You need a complete commercial AML/KYC database or a legal guarantee that a subject is unsanctioned.
Limitations: Fuzzy name matching can produce false positives and false negatives, especially for aliases, transliteration and common names. No match means only that no candidate was found in the supported public lists at check time.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `name` (string, required): Person or organization name to compare with the supported public sanctions and asset-freeze lists. (minimum length 2; maximum length 200).
- `threshold` (integer): Minimum fuzzy-match score accepted as a candidate public-list match. (minimum 50; maximum 100; default 85).

Output parameters:

- `checked_at` (string): UTC timestamp at which HelpMyAgent performed the check.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `match_count` (integer): Number of candidate matches returned by the screening operation.
- `matches` (array): Candidate public-list or source matches returned by the endpoint.
- `name` (string): Publicly available company, person, buyer or record name for this result.
- `sources` (array): Public data sources used or checked for this result.
- `status` (string): Normalized endpoint or source status.
- `threshold` (integer): Structured value returned for “threshold” as defined by this API contract.

### `iban_validate` (~278 tokens)

IBAN Structure Validation

Validates IBAN structure and mod-97 checksum locally and extracts French bank/branch/account components when present.
Use when: Validate an IBAN checksum before using it in a workflow. You need local IBAN normalization, structural validation and mod-97 checksum verification before using an account identifier. For French IBANs, you also want the available bank, branch, account and RIB-key components.
Avoid when: You need to verify that an IBAN belongs to a specific supplier; structural validation cannot establish ownership. You need supplier-level public identity/compliance context; use company/fr/supplier-verification.
Limitations: A checksum-valid IBAN can still refer to a closed, nonexistent or unrelated bank account. Bank/BIC enrichment is returned only when supported by the endpoint’s available reference data.
Price: 0.002 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `iban` (string, required): IBAN to normalize and validate structurally, including the ISO 13616 mod-97 checksum. (minimum length 15; maximum length 34).

Output parameters:

- `account_number` (string|null): Structured value returned for “account number” as defined by this API contract.
- `bank_code` (string|null): Structured value returned for “bank code” as defined by this API contract.
- `bank_name` (string|null): Structured value returned for “bank name” as defined by this API contract.
- `bic` (string|null): Structured value returned for “bic” as defined by this API contract.
- `branch_code` (string|null): Structured value returned for “branch code” as defined by this API contract.
- `checked_at` (string): UTC timestamp at which HelpMyAgent performed the check.
- `checksum_valid` (boolean): Structured value returned for “checksum valid” as defined by this API contract.
- `country_code` (string): Structured value returned for “country code” as defined by this API contract.
- `expected_length` (integer|null): Structured value returned for “expected length” as defined by this API contract.
- `iban` (string): Structured value returned for “iban” as defined by this API contract.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `rib_key` (string|null): Structured value returned for “rib key” as defined by this API contract.
- `structure_valid` (boolean): Structured value returned for “structure valid” as defined by this API contract.
- `valid` (boolean): Whether the supplied identifier passed the endpoint’s validation rules.

### `procurement_fr_awards` (~389 tokens)

French Public Contract Awards

Searches awarded French public contracts using DECP filters for CPV, location, buyer, holder, dates and amounts.
Use when: Search French public contracts that have already been awarded using CPV, location, buyer, holder, date or amount filters.
Avoid when: Use procurement/fr/search for currently open BOAMP tenders. Use company/fr/public-contracts when you only need contracts awarded to one known French company.
Limitations: Coverage follows the published DECP dataset and source fields.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `buyer` (string): Public-buyer name or identifier used to restrict procurement results. (minimum length 2; maximum length 200).
- `cpv_prefix` (string): Optional CPV prefix used to restrict procurement records to a purchasing segment.
- `date_from` (string): Optional value for “date from” as defined by this API contract.
- `date_to` (string): Optional value for “date to” as defined by this API contract.
- `department` (string): Optional French department code used to restrict results geographically.
- `holder` (string): Optional value for “holder” as defined by this API contract.
- `limit` (integer): Maximum number of records returned by this call. (minimum 1; maximum 50; default 20).
- `max_amount` (number): Optional value for “max amount” as defined by this API contract. (minimum 0).
- `min_amount` (number): Optional value for “min amount” as defined by this API contract. (minimum 0).

Output parameters:

- `awards` (array): Structured value returned for “awards” as defined by this API contract.
- `filters` (object): Structured value returned for “filters” as defined by this API contract.
- `generated_at` (string): UTC timestamp at which this derived result was generated.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `returned_count` (integer|null): Number of records included in this response.
- `source_status` (string): Availability status of the relevant upstream public source. (allowed values: ok, unavailable).
- `total_count` (integer|null): Total number of matching records reported by the source or endpoint.
- `truncated` (boolean|null): Whether additional matching records existed beyond the returned result limit.

### `procurement_fr_buyer_profile` (~291 tokens)

French Public Buyer Profile

Builds a compact DECP profile for a French public buyer by name or SIRET.
Use when: Profile a French public buyer from its published contract records. You need a compact historical procurement profile for a French public buyer identified by name or SIRET. You want published award volume, recent activity, top CPV segments and frequent suppliers from DECP data.
Avoid when: You need currently open tenders from that buyer; use procurement/fr/search. You need one supplier’s awarded-contract history; use company/fr/public-contracts.
Limitations: The profile is derived from the sampled/public DECP award records matched to the buyer query. Published contract records do not represent every purchasing activity or off-contract expenditure of the buyer.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `buyer` (string, required): French public-buyer name or SIRET used to build the procurement profile. (minimum length 2; maximum length 200).
- `limit` (integer): Maximum number of records returned by this call. (minimum 1; maximum 100; default 100).

Output parameters:

- `buyer_name` (string|null): Structured value returned for “buyer name” as defined by this API contract.
- `buyer_siret` (string|null): Structured value returned for “buyer siret” as defined by this API contract.
- `by_year` (array): Structured value returned for “by year” as defined by this API contract.
- `generated_at` (string): UTC timestamp at which this derived result was generated.
- `latest_notification_date` (string|null): Structured value returned for “latest notification date” as defined by this API contract.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `query` (string): Structured value returned for “query” as defined by this API contract.
- `sampled_amount` (number|integer|null): Structured value returned for “sampled amount” as defined by this API contract.
- `sampled_count` (integer|null): Structured value returned for “sampled count” as defined by this API contract.
- `source_status` (string): Availability status of the relevant upstream public source. (allowed values: ok, unavailable).
- `top_cpv` (array): Structured value returned for “top cpv” as defined by this API contract.
- `top_suppliers` (array): Structured value returned for “top suppliers” as defined by this API contract.
- `total_count` (integer|null): Total number of matching records reported by the source or endpoint.

### `procurement_fr_deadlines` (~335 tokens)

French Public Contract Expiry & Renewal Signals

Estimates upcoming public-contract end dates using DECP notification, initial duration and published duration modifications, with an explicit confidence level.
Use when: Find French public contracts likely to expire or renew soon, taking published DECP duration modifications into account.
Avoid when: You need open tenders rather than awarded-contract expiry signals; use procurement/fr/search.
Limitations: End dates remain estimates; confidence is reduced when DECP reports a modification without a revised duration. Malformed or non-date DECP modification fields are ignored and an isolated modification identifier no longer creates a modification signal by itself.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `cpv_prefix` (string): Optional CPV code prefix used to restrict public-contract expiry estimates to a procurement segment.
- `department` (string): Optional French department code used to restrict results geographically.
- `limit` (integer): Maximum number of records returned by this call. (minimum 1; maximum 50; default 25).
- `max_months` (integer): Maximum number of months from now before the estimated contract end date. (minimum 1; maximum 60; default 18).
- `min_months` (integer): Minimum number of months from now before the estimated contract end date. (minimum 0; maximum 60; default 0).

Output parameters:

- `contracts` (array): Normalized public-contract records returned by the endpoint.
- `cpv_prefix` (string|null): Structured value returned for “cpv prefix” as defined by this API contract.
- `department` (string|null): Structured value returned for “department” as defined by this API contract.
- `generated_at` (string): UTC timestamp at which this derived result was generated.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `max_months` (integer): Structured value returned for “max months” as defined by this API contract.
- `min_months` (integer): Structured value returned for “min months” as defined by this API contract.
- `returned_count` (integer|null): Number of records included in this response.
- `source_status` (string): Availability status of the relevant upstream public source. (allowed values: ok, unavailable).

### `procurement_fr_market` (~285 tokens)

French Public Procurement Market

Summarizes the size and structure of a French public-procurement segment from awarded DECP contracts.
Use when: Measure the size and structure of a French public-procurement segment over a recent time window.
Avoid when: Use procurement/fr/awards when you need individual awarded-contract records. Use procurement/fr/buyer-profile when the question is specifically about one public buyer.
Limitations: Supplier ranking is based on the latest 100 matching awards; its sample coverage is returned explicitly.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `buyer` (string): Public-buyer name or identifier used to restrict procurement results. (minimum length 2; maximum length 200).
- `cpv_prefix` (string): Optional CPV prefix used to restrict procurement records to a purchasing segment.
- `department` (string): Optional French department code used to restrict results geographically.
- `lookback_months` (integer): Optional value for “lookback months” as defined by this API contract. (minimum 1; maximum 60; default 12).

Output parameters:

- `filters` (object): Structured value returned for “filters” as defined by this API contract.
- `generated_at` (string): UTC timestamp at which this derived result was generated.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `lookback_months` (integer): Structured value returned for “lookback months” as defined by this API contract.
- `source_status` (string): Availability status of the relevant upstream public source. (allowed values: ok, partial, unavailable).
- `summary` (object): Compact derived summary of the returned records.
- `supplier_sample_coverage_percent` (number|integer|null): Structured value returned for “supplier sample coverage percent” as defined by this API contract.
- `supplier_sampled_count` (integer|null): Structured value returned for “supplier sampled count” as defined by this API contract.
- `top_buyers` (array): Structured value returned for “top buyers” as defined by this API contract.
- `top_cpv` (array): Structured value returned for “top cpv” as defined by this API contract.
- `top_suppliers_in_latest_sample` (array): Structured value returned for “top suppliers in latest sample” as defined by this API contract.

### `procurement_fr_search` (~291 tokens)

French Public Procurement Search

Searches currently open French public procurement opportunities and returns normalized BOAMP tender data ready for automated processing.
Use when: You need currently open French public procurement opportunities from BOAMP. You want to search open tenders by keywords, department, buyer or minimum deadline.
Avoid when: You need contracts already awarded to a specific company; use company/fr/public-contracts. You need private procurement opportunities or a guarantee that every French public procurement notice is covered.
Limitations: Coverage is limited to the BOAMP public dataset and the notices available through that source. At least one of query, department or buyer is required; tender deadlines and notice details can change at the source.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `buyer` (string): Public buyer name to search for
- `deadline_after` (string): Only return tenders whose deadline is on or after this YYYY-MM-DD date
- `department` (string): French department code
- `limit` (integer): Maximum number of open tenders to return
- `query` (string): Keywords to search in currently open public procurement notices

Output parameters:

- `buyer` (string|null): Structured value returned for “buyer” as defined by this API contract.
- `deadline_after` (string|null): Structured value returned for “deadline after” as defined by this API contract.
- `department` (string|null): Structured value returned for “department” as defined by this API contract.
- `query` (string|null): Structured value returned for “query” as defined by this API contract.
- `returned_count` (integer): Number of records included in this response.
- `tenders` (array): Normalized open public-procurement notices returned by the endpoint.
- `total_count` (integer): Total number of matching records reported by the source or endpoint.
- `truncated` (boolean): Whether additional matching records existed beyond the returned result limit.

### `procurement_fr_trends` (~302 tokens)

French Public Procurement Trends

Builds monthly or yearly time series of awarded French public-contract volumes and amounts from DECP.
Use when: Track how French awarded public-contract volumes and amounts evolve month by month or year by year.
Avoid when: Use procurement/fr/market for a current segment overview without a time series. Use procurement/fr/search for open tender opportunities.
Limitations: The current partial month or year can mechanically reduce the latest period.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `buyer` (string): Public-buyer name or identifier used to restrict procurement results. (minimum length 2; maximum length 200).
- `cpv_prefix` (string): Optional CPV prefix used to restrict procurement records to a purchasing segment.
- `department` (string): Optional French department code used to restrict results geographically.
- `granularity` (string): Optional value for “granularity” as defined by this API contract. (default month; allowed values: month, year).
- `lookback_months` (integer): Optional value for “lookback months” as defined by this API contract. (minimum 1; maximum 60; default 24).

Output parameters:

- `filters` (object): Structured value returned for “filters” as defined by this API contract.
- `generated_at` (string): UTC timestamp at which this derived result was generated.
- `granularity` (string): Structured value returned for “granularity” as defined by this API contract. (allowed values: month, year).
- `latest_period_contracts_change_percent` (number|integer|null): Structured value returned for “latest period contracts change percent” as defined by this API contract.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `lookback_months` (integer): Structured value returned for “lookback months” as defined by this API contract.
- `periods_count` (integer|null): Structured value returned for “periods count” as defined by this API contract.
- `series` (array): Structured value returned for “series” as defined by this API contract.
- `source_status` (string): Availability status of the relevant upstream public source. (allowed values: ok, unavailable).

### `real_estate_fr_dpe` (~237 tokens)

French Property DPE

Finds ADEME energy-performance certificates for an address or French municipality.
Use when: Find residential DPE records for a French address or municipality.
Avoid when: An address can contain several dwellings and therefore several DPE records.
Limitations: ADEME republishes data submitted by diagnosticians; an address match does not guarantee identification of the exact dwelling.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `address` (string): Optional value for “address” as defined by this API contract. (minimum length 5; maximum length 250).
- `code_insee` (string): Optional value for “code insee” as defined by this API contract.
- `limit` (integer): Maximum number of records returned by this call. (minimum 1; maximum 50; default 10).

Output parameters:

- `dpe` (array): Structured value returned for “dpe” as defined by this API contract.
- `generated_at` (string): UTC timestamp at which this derived result was generated.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `location` (object): Structured value returned for “location” as defined by this API contract.
- `returned_count` (integer|null): Number of records included in this response.
- `source_status` (string): Availability status of the relevant upstream public source. (allowed values: ok).
- `total_count` (integer|null): Total number of matching records reported by the source or endpoint.
- `truncated` (boolean|null): Whether additional matching records existed beyond the returned result limit.

### `real_estate_fr_market` (~359 tokens)

French Real-estate Market

Summarizes local French property transaction prices and yearly trends from geolocated DVF data.
Use when: Summarize a French local property market from recorded transactions.
Avoid when: Do not use as a listing-price index or a certified appraisal.
Limitations: Statistics use up to 200 geolocated DVF single-dwelling mutations per year and residential property type; VEFA/new and professional-use mutations are excluded, with truncation exposed explicitly. DVF does not cover Alsace, Moselle or Mayotte; requests in those areas therefore return an empty result.
Price: 0.020 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `address` (string): Optional value for “address” as defined by this API contract. (minimum length 5; maximum length 250).
- `code_insee` (string): Optional value for “code insee” as defined by this API contract.
- `lookback_years` (integer): Optional value for “lookback years” as defined by this API contract. (minimum 1; maximum 5; default 5).
- `property_type` (string): Optional value for “property type” as defined by this API contract. (default all; allowed values: all, house, apartment).
- `radius_m` (integer): Optional value for “radius m” as defined by this API contract. (minimum 100; maximum 650; default 650).

Output parameters:

- `coverage_scope` (string): Structured value returned for “coverage scope” as defined by this API contract. (allowed values: radius, commune).
- `generated_at` (string): UTC timestamp at which this derived result was generated.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `location` (object): Structured value returned for “location” as defined by this API contract.
- `lookback_years` (integer): Structured value returned for “lookback years” as defined by this API contract.
- `property_type` (string): Structured value returned for “property type” as defined by this API contract.
- `radius_m` (integer|null): Structured value returned for “radius m” as defined by this API contract.
- `sample_truncated` (boolean|null): Structured value returned for “sample truncated” as defined by this API contract.
- `sampled_count` (integer|null): Structured value returned for “sampled count” as defined by this API contract.
- `source_status` (string): Availability status of the relevant upstream public source. (allowed values: ok).
- `source_total_count` (integer|null): Structured value returned for “source total count” as defined by this API contract.
- `summary` (object): Compact derived summary of the returned records.
- `yearly` (array): Structured value returned for “yearly” as defined by this API contract.

### `real_estate_fr_parcel` (~257 tokens)

French Cadastral Parcel

Identifies French cadastral parcels by address point or cadastral municipality/section/number and returns official IGN geometry.
Use when: Identify a French cadastral parcel and retrieve its geometry.
Avoid when: Do not treat this as a legally opposable property-title document.
Limitations: Address search intersects the geocoded point with cadastral geometry and can return multiple parcels on a parcel boundary.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `address` (string): Optional value for “address” as defined by this API contract. (minimum length 5; maximum length 250).
- `code_insee` (string): Optional value for “code insee” as defined by this API contract.
- `numero` (string|integer): Optional value for “numero” as defined by this API contract.
- `section` (string): Optional value for “section” as defined by this API contract.

Output parameters:

- `bbox` (array|null): Structured value returned for “bbox” as defined by this API contract.
- `generated_at` (string): UTC timestamp at which this derived result was generated.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `location` (object): Structured value returned for “location” as defined by this API contract.
- `parcels` (array): Structured value returned for “parcels” as defined by this API contract.
- `source_status` (string): Availability status of the relevant upstream public source. (allowed values: ok).
- `total_count` (integer|null): Total number of matching records reported by the source or endpoint.

### `real_estate_fr_risks` (~215 tokens)

French Property Risks

Returns the types of natural and technological risks recorded by Géorisques/GASPAR for the municipality of a French property location.
Use when: Screen the municipality of a French property location for recorded risk types.
Avoid when: Do not interpret municipality-level risk presence as parcel-level exposure.
Limitations: This endpoint works at municipality level and is not a regulatory parcel-level risk statement.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `address` (string): Optional value for “address” as defined by this API contract. (minimum length 5; maximum length 250).
- `code_insee` (string): Optional value for “code insee” as defined by this API contract.

Output parameters:

- `generated_at` (string): UTC timestamp at which this derived result was generated.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `location` (object): Structured value returned for “location” as defined by this API contract.
- `risk_count` (integer|null): Structured value returned for “risk count” as defined by this API contract.
- `risks` (array): Structured value returned for “risks” as defined by this API contract.
- `scope` (string): Structured value returned for “scope” as defined by this API contract. (allowed values: commune).
- `source_status` (string): Availability status of the relevant upstream public source. (allowed values: ok).

### `real_estate_fr_transactions` (~441 tokens)

French Real-estate Transactions

Searches published French geolocated DVF property transactions by address area or municipality, with date, type and amount filters.
Use when: Find actual French property sales around an address or in a municipality.
Avoid when: Do not use for current property listings or asking prices.
Limitations: Geolocated DVF reflects published transactions and can include complex mutations; HelpMyAgent only calculates price per square metre for single-house or single-apartment mutations. DVF does not cover Alsace, Moselle or Mayotte; requests in those areas therefore return an empty result.
Price: 0.010 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `address` (string): Optional value for “address” as defined by this API contract. (minimum length 5; maximum length 250).
- `code_insee` (string): Optional value for “code insee” as defined by this API contract.
- `date_from` (string): Optional value for “date from” as defined by this API contract.
- `date_to` (string): Optional value for “date to” as defined by this API contract.
- `limit` (integer): Maximum number of records returned by this call. (minimum 1; maximum 100; default 20).
- `max_amount` (number): Optional value for “max amount” as defined by this API contract. (minimum 0).
- `min_amount` (number): Optional value for “min amount” as defined by this API contract. (minimum 0).
- `property_type` (string): Optional value for “property type” as defined by this API contract. (default all; allowed values: all, house, apartment).
- `radius_m` (integer): Optional value for “radius m” as defined by this API contract. (minimum 100; maximum 650; default 500).

Output parameters:

- `coverage_scope` (string): Structured value returned for “coverage scope” as defined by this API contract. (allowed values: radius, commune).
- `generated_at` (string): UTC timestamp at which this derived result was generated.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `location` (object): Structured value returned for “location” as defined by this API contract.
- `property_type` (string): Structured value returned for “property type” as defined by this API contract.
- `radius_m` (integer|null): Structured value returned for “radius m” as defined by this API contract.
- `returned_count` (integer|null): Number of records included in this response.
- `source_status` (string): Availability status of the relevant upstream public source. (allowed values: ok).
- `source_total_count` (integer|null): Structured value returned for “source total count” as defined by this API contract.
- `transactions` (array): Structured value returned for “transactions” as defined by this API contract.
- `truncated` (boolean|null): Whether additional matching records existed beyond the returned result limit.

### `real_estate_fr_valuation` (~387 tokens)

French Property Valuation

Estimates a statistical property value range from nearby or municipal geolocated DVF comparable transactions.
Use when: Estimate a French house or apartment from comparable recorded sales.
Avoid when: Do not present the result as a certified appraisal or guaranteed sale price.
Limitations: Valuation depends on the density of single-dwelling geolocated DVF comparables; VEFA/new and professional-use mutations are excluded, and built area may differ from Carrez area. DVF does not cover Alsace, Moselle or Mayotte; requests in those areas therefore return an empty result.
Price: 0.030 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `address` (string): Optional value for “address” as defined by this API contract. (minimum length 5; maximum length 250).
- `code_insee` (string): Optional value for “code insee” as defined by this API contract.
- `lookback_years` (integer): Optional value for “lookback years” as defined by this API contract. (minimum 1; maximum 5; default 3).
- `property_type` (string, required): Required value for “property type” as defined by this API contract. (allowed values: house, apartment).
- `radius_m` (integer): Optional value for “radius m” as defined by this API contract. (minimum 100; maximum 650; default 650).
- `surface_m2` (number, required): Required value for “surface m2” as defined by this API contract. (minimum 9; maximum 1000).

Output parameters:

- `comparable_count` (integer|null): Structured value returned for “comparable count” as defined by this API contract.
- `comparables` (array): Structured value returned for “comparables” as defined by this API contract.
- `confidence` (string): Confidence indicator associated with an inferred or derived result. (allowed values: high, medium, low, insufficient).
- `estimated_range_high` (number|integer|null): Structured value returned for “estimated range high” as defined by this API contract.
- `estimated_range_low` (number|integer|null): Structured value returned for “estimated range low” as defined by this API contract.
- `estimated_value` (number|integer|null): Structured value returned for “estimated value” as defined by this API contract.
- `generated_at` (string): UTC timestamp at which this derived result was generated.
- `limitations` (array): Known interpretation, source-coverage or freshness limitations for this result.
- `location` (object): Structured value returned for “location” as defined by this API contract.
- `lookback_years` (integer): Structured value returned for “lookback years” as defined by this API contract.
- `median_price_per_m2` (number|integer|null): Structured value returned for “median price per m2” as defined by this API contract.
- `p25_price_per_m2` (number|integer|null): Structured value returned for “p25 price per m2” as defined by this API contract.
- `p75_price_per_m2` (number|integer|null): Structured value returned for “p75 price per m2” as defined by this API contract.
- `property_type` (string): Structured value returned for “property type” as defined by this API contract.
- `radius_m` (integer|null): Structured value returned for “radius m” as defined by this API contract.
- `source_status` (string): Availability status of the relevant upstream public source. (allowed values: ok).
- `source_total_count` (integer|null): Structured value returned for “source total count” as defined by this API contract.
- `source_truncated` (boolean|null): Structured value returned for “source truncated” as defined by this API contract.
- `surface_m2` (number): Structured value returned for “surface m2” as defined by this API contract.

### `vat_eu_validate` (~303 tokens)

EU VAT Validation

Validates an EU VAT number through the European Commission VIES service, with explicit unavailable status.
Use when: Validate an EU VAT number before invoicing or supplier onboarding. You need to validate an EU VAT number through the European Commission VIES service before invoicing or onboarding. You have either a complete VAT number or a country code plus national number.
Avoid when: You need invoice-level consistency for a French company identifier; use company/fr/invoice-check. You need broader supplier identity, compliance or IBAN checks; use company/fr/supplier-verification.
Limitations: Validation depends on VIES availability and on the member-state data returned through that service. A valid VAT number does not prove bank-account ownership, solvency or absence of fraud.
Price: 0.005 USD per call via x402.
Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment.
Accepted x402 networks: eip155:8453, xrpl:0.

Input parameters:

- `country_code` (string): EU/VIES country prefix used when the VAT number is supplied in separate parts.
- `number` (string): National VAT identifier body without the country prefix, used together with country_code.
- `vat_number` (string): Complete EU VAT number including the two-letter country prefix; alternatively provide country_code and number separately.

Output parameters:

- `address` (string|null): Structured value returned for “address” as defined by this API contract.
- `checked_at` (string): UTC timestamp at which HelpMyAgent performed the check.
- `country_code` (string): Structured value returned for “country code” as defined by this API contract.
- `name` (string|null): Publicly available company, person, buyer or record name for this result.
- `number` (string): Structured value returned for “number” as defined by this API contract.
- `request_date` (string|null): Structured value returned for “request date” as defined by this API contract.
- `request_identifier` (string|null): Structured value returned for “request identifier” as defined by this API contract.
- `source` (string): Structured value returned for “source” as defined by this API contract.
- `status` (string): Normalized endpoint or source status.
- `valid` (boolean|null): Whether the supplied identifier passed the endpoint’s validation rules.
- `vat_number` (string): Structured value returned for “vat number” as defined by this API contract.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/helpmyagent-helpmyagent/api#diagnostics

## Score history

- 2026-09-20: 73
- 2026-09-19: 72
- 2026-09-18: 72
- 2026-09-17: 71
- 2026-09-16: 71
- 2026-09-15: 70
- 2026-09-14: 70
- 2026-09-13: 69
- 2026-09-12: 69
- 2026-09-11: 69
- 2026-09-10: 68
- 2026-09-09: 68
- 2026-09-08: 67
- 2026-09-07: 58
- 2026-09-06: 60
- 2026-09-05: 60
- 2026-09-04: 59
- 2026-09-03: 59

## Common questions

### What is the HelpMyAgent MCP server?

HelpMyAgent is an MCP server listed in the public MCP registry as io.github.helpmyagent/helpmyagent. Pay-per-call data APIs for AI agents: business, compliance, procurement, VAT and IBAN via x402. This page covers its hosted endpoint (https://api.helpmyagent.com/mcp).

### Is the HelpMyAgent MCP server safe to use?

HelpMyAgent scores 73 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the HelpMyAgent MCP server expose?

HelpMyAgent exposes 59 tools: search_apis, describe_api, list_categories, company_fr_aids, company_fr_benchmark, and 54 more. Their descriptions and schemas cost roughly 16,620 tokens of context every time the server is loaded.

### Does the HelpMyAgent MCP server require authentication?

No. We connected to HelpMyAgent without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the HelpMyAgent MCP server still maintained?

HelpMyAgent is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://api.helpmyagent.com/mcp
- Website: https://helpmyagent.com/
- Changelog RSS feed: https://verifymcp.io/servers/helpmyagent-helpmyagent/api.xml
- Changelog JSON feed: https://verifymcp.io/servers/helpmyagent-helpmyagent/api.json
- HTML version of this page: https://verifymcp.io/servers/helpmyagent-helpmyagent/api