HelpMyAgent
REMOTE · API.HELPMYAGENT.COM · SCANNED SEP 20
Pay-per-call data APIs for AI agents: business, compliance, procurement, VAT and IBAN via x402.
Available components
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. How we score → Why this is hard to score →
Endpoint Security63
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one. See how to fix → View diagnostics → Partial
- HTTPS check failed: the endpoint is reachable over plaintext HTTP. See how to fix → View diagnostics → Fail
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability64
- AI-judged instruction clarity (excellent).Pass
- 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. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management57
- Stability observed for 17 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 59 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 60 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
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.
remote · api.helpmyagent.com
claude mcp add --transport http helpmyagent-helpmyagent 'https://api.helpmyagent.com/mcp'
{
"mcpServers": {
"helpmyagent-helpmyagent": {
"url": "https://api.helpmyagent.com/mcp"
}
}
} {
"servers": {
"helpmyagent-helpmyagent": {
"type": "http",
"url": "https://api.helpmyagent.com/mcp"
}
}
} [mcp_servers.helpmyagent-helpmyagent] url = "https://api.helpmyagent.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"helpmyagent-helpmyagent": {
"type": "remote",
"url": "https://api.helpmyagent.com/mcp",
"enabled": true
}
}
} openclaw mcp add helpmyagent-helpmyagent --url 'https://api.helpmyagent.com/mcp' --transport streamable-http
mcp_servers:
helpmyagent-helpmyagent:
url: "https://api.helpmyagent.com/mcp" {
"McpServers": {
"helpmyagent-helpmyagent": {
"Transport": "http",
"Url": "https://api.helpmyagent.com/mcp"
}
}
} assistant mcp add helpmyagent-helpmyagent -t streamable-http -u 'https://api.helpmyagent.com/mcp'
{
"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.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 20 Sept 26 +1
- A breaking change shipped without a version bump: still v1 ▼ security
- Tool “company_fr_competitors” was removed ▼ security
- Tool “company_fr_kyb” was removed ▼ security
- Tool “company_fr_legal_announcements_since” was removed ▼ security
- 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 security
- “company_fr_intelligence” added an optional parameter “domain” cosmetic
- 18 Sept 26 +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.
- 16 Sept 26 +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.
- 14 Sept 26 +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.
- 11 Sept 26 +1
- 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” functional
- 10 Sept 26 0
- 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 security
- 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” functional
- “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 cosmetic
- 9 Sept 26 +1
- 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 security
- “describe_api” reworded the description of “endpoint” cosmetic
- “search_apis” reworded the description of “category” cosmetic
- 8 Sept 26 +9
- 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 security
- Schema quality: 158 → 284 ▼ functional
- Tool coverage: 29% → 100% ▲ functional
- Schema quality: good → excellent functional
- “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” cosmetic
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Probed https://api.helpmyagent.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=helpmyagent.com | CN=WE1,O=Google Trust Services,C=US | 29 Aug 2026 | 27 Nov 2026 | ECDSA 256 | ECDSA-SHA256 | 8b7c52e4b64d66fe139dcd565573a68c |
| SANs: helpmyagent.com, *.helpmyagent.com | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of api.helpmyagent.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| helpmyagent.com. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| x-content-type-options | nosniff |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://api.helpmyagent.com/mcp | Verified | 200 | |
| http (plaintext) | http://api.helpmyagent.com/mcp | Served over HTTP | 200 |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
company_fr_aids French Company Public Funding ~309
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 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 |
| Name | Type | Req | Description |
|---|---|---|---|
| aids | array | yes | Ranked public funding schemes returned by the endpoint. |
| company_status | string|null | yes | Current public administrative company status when available. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| identifier_type | string | yes | 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 | yes | Structured value returned for “matching context” as defined by this API contract. |
| name | string|null | yes | Publicly available company, person, buyer or record name for this result. |
| returned_count | integer | yes | Number of records included in this response. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
| source_total_count | integer | yes | Structured value returned for “source total count” as defined by this API contract. |
| total_candidates | integer | yes | Structured value returned for “total candidates” as defined by this API contract. |
| truncated | boolean | yes | Whether additional matching records existed beyond the returned result limit. |
No examples provided.
company_fr_benchmark Benchmark a French company against public peers ~323
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 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). |
| Name | Type | Req | Description |
|---|---|---|---|
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | 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 | yes | Structured value returned for “metrics” as defined by this API contract. |
| name | – | yes | Publicly available company, person, buyer or record name for this result. |
| peer_count | integer | yes | Structured value returned for “peer count” as defined by this API contract. |
| peers | array | yes | Structured value returned for “peers” as defined by this API contract. |
| scope | string | yes | Structured value returned for “scope” as defined by this API contract. |
| siren | – | yes | Normalized 9-digit French SIREN when available. |
No examples provided.
company_fr_certifications French Company Certifications ~252
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 9-digit SIREN or 14-digit SIRET |
| Name | Type | Req | Description |
|---|---|---|---|
| certifications | array | yes | Normalized public certification records returned by the endpoint. |
| certifications_count | integer | yes | Structured value returned for “certifications count” as defined by this API contract. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| identifier_type | string | yes | Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret). |
| name | string|null | yes | Publicly available company, person, buyer or record name for this result. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
| sources | array | yes | Public data sources used or checked for this result. |
No examples provided.
company_fr_changes French Company Changes ~282
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 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 |
| Name | Type | Req | Description |
|---|---|---|---|
| changes | array | yes | Structured value returned for “changes” as defined by this API contract. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| identifier_type | string | yes | Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret). |
| limit | integer | yes | 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 | yes | Structured value returned for “next offset” as defined by this API contract. |
| offset | integer | yes | Structured value returned for “offset” as defined by this API contract. |
| returned_count | integer | yes | Number of records included in this response. |
| since | string|null | yes | Structured value returned for “since” as defined by this API contract. |
| siren | string | yes | Normalized 9-digit French SIREN when available. |
| total_count | integer | yes | Total number of matching records reported by the source or endpoint. |
| truncated | boolean | yes | Whether additional matching records existed beyond the returned result limit. |
| until | string|null | yes | Structured value returned for “until” as defined by this API contract. |
No examples provided.
company_fr_closures French Company Closures ~280
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 |
| Name | Type | Req | Description |
|---|---|---|---|
| closures | array | yes | Structured value returned for “closures” as defined by this API contract. |
| cursor | string | yes | Structured value returned for “cursor” as defined by this API contract. |
| limit | integer | yes | 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 | yes | Structured value returned for “next cursor” as defined by this API contract. |
| returned_count | integer | yes | Number of records included in this response. |
| since | string | yes | Structured value returned for “since” as defined by this API contract. |
| total_count | integer | yes | Total number of matching records reported by the source or endpoint. |
| truncated | boolean | yes | Whether additional matching records existed beyond the returned result limit. |
| until | string | yes | Structured value returned for “until” as defined by this API contract. |
No examples provided.
company_fr_compare Compare French companies ~281
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifiers | array | yes | 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). |
| Name | Type | Req | Description |
|---|---|---|---|
| companies | array | yes | Structured company records returned by the endpoint. |
| comparability | object | yes | 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 | yes | Structured value returned for “rankings” as defined by this API contract. |
No examples provided.
company_fr_compliance French Company Compliance Checks ~300
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.
| Name | Type | Req | Description |
|---|---|---|---|
| domain | string | – | Optional domain to check separately; it is not considered officially associated with the company |
| identifier | string | yes | 9-digit SIREN or 14-digit SIRET |
| Name | Type | Req | Description |
|---|---|---|---|
| checked_at | string | yes | UTC timestamp at which HelpMyAgent performed the check. |
| checks | array | yes | Structured value returned for “checks” as defined by this API contract. |
| company_status | string|null | yes | Current public administrative company status when available. |
| domain | string|null | yes | Structured value returned for “domain” as defined by this API contract. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| identifier_type | string | yes | 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 | yes | Candidate public-list or source matches returned by the endpoint. |
| name | string|null | yes | 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 | yes | Normalized 9-digit French SIREN when available. |
| status | string | yes | Normalized endpoint or source status. (allowed values: PUBLIC_ALERT_FOUND, NO_PUBLIC_ALERT_FOUND, INCOMPLETE, COMPANY_NOT_FOUND). |
No examples provided.
company_fr_default_score Explainable public default-risk indicator ~265
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | French company identifier: 9-digit SIREN or 14-digit SIRET. |
| Name | Type | Req | Description |
|---|---|---|---|
| components | array | yes | Structured value returned for “components” as defined by this API contract. |
| confidence | string | yes | Confidence indicator associated with an inferred or derived result. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| identifier_type | string | yes | 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 | yes | Structured value returned for “level” as defined by this API contract. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| name | – | yes | Publicly available company, person, buyer or record name for this result. |
| score | – | yes | Normalized score produced by the endpoint; interpretation is defined by the tool description and limitations. |
| siren | – | yes | Normalized 9-digit French SIREN when available. |
No examples provided.
company_fr_director_mandates French director mandates ~332
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.
| Name | Type | Req | Description |
|---|---|---|---|
| first_names | string | – | Optional first name or given names used to narrow director-mandate matches. |
| last_name | string | yes | 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). |
| Name | Type | Req | Description |
|---|---|---|---|
| first_names | – | yes | Structured value returned for “first names” as defined by this API contract. |
| last_name | string | yes | Structured value returned for “last name” as defined by this API contract. |
| limit | integer | yes | 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 | yes | Structured value returned for “mandates” as defined by this API contract. |
| page | integer | yes | Structured value returned for “page” as defined by this API contract. |
| returned_mandates | integer | yes | Structured value returned for “returned mandates” as defined by this API contract. |
| total_companies | integer | yes | Structured value returned for “total companies” as defined by this API contract. |
No examples provided.
company_fr_directors French Company Directors ~220
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 9-digit SIREN or 14-digit SIRET |
| Name | Type | Req | Description |
|---|---|---|---|
| directors | array | yes | Publicly listed directors or legal representatives returned by the endpoint. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| identifier_type | string | yes | Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret). |
| name | string|null | yes | Publicly available company, person, buyer or record name for this result. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
No examples provided.
company_fr_e_invoice French E-Invoice Preparation ~252
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | French company identifier: 9-digit SIREN or 14-digit SIRET. |
| Name | Type | Req | Description |
|---|---|---|---|
| company_category | string|null | yes | Structured value returned for “company category” as defined by this API contract. |
| establishment_scope | string | yes | Structured value returned for “establishment scope” as defined by this API contract. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| headquarters_address | string|null | yes | Structured value returned for “headquarters address” as defined by this API contract. |
| headquarters_siret | string|null | yes | Structured value returned for “headquarters siret” as defined by this API contract. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| issuing_obligation_from | string|null | yes | 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 | yes | Publicly available company, person, buyer or record name for this result. |
| prepared_at | string | yes | Structured value returned for “prepared at” as defined by this API contract. |
| receiving_obligation_from | string|null | yes | Structured value returned for “receiving obligation from” as defined by this API contract. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
| vat_number | string|null | yes | Structured value returned for “vat number” as defined by this API contract. |
No examples provided.
company_fr_establishments French Company Establishments ~252
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.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | – | Opaque Sirene cursor from next_cursor; omit it on the first call |
| identifier | string | yes | 9-digit SIREN or 14-digit SIRET |
| limit | integer | – | Maximum establishments to return, up to 100 |
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | yes | Structured value returned for “cursor” as defined by this API contract. |
| establishments | array | yes | Structured value returned for “establishments” as defined by this API contract. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| identifier_type | string | yes | Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret). |
| limit | integer | yes | Structured value returned for “limit” as defined by this API contract. |
| next_cursor | string|null | yes | Structured value returned for “next cursor” as defined by this API contract. |
| returned_count | integer | yes | Number of records included in this response. |
| siren | string | yes | Normalized 9-digit French SIREN when available. |
| total_count | integer | yes | Total number of matching records reported by the source or endpoint. |
| truncated | boolean | yes | Whether additional matching records existed beyond the returned result limit. |
No examples provided.
company_fr_events French Company Events ~278
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 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 |
| Name | Type | Req | Description |
|---|---|---|---|
| events | array | yes | Normalized public events returned by the endpoint. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| identifier_type | string | yes | Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret). |
| latest_event | object|null | yes | Structured value returned for “latest event” as defined by this API contract. |
| name | string|null | yes | Publicly available company, person, buyer or record name for this result. |
| returned_count | integer | yes | Number of records included in this response. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
| total_count | integer | yes | Total number of matching records reported by the source or endpoint. |
| truncated | boolean | yes | Whether additional matching records existed beyond the returned result limit. |
No examples provided.
company_fr_financials French Company Financials ~247
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 9-digit SIREN or 14-digit SIRET |
| Name | Type | Req | Description |
|---|---|---|---|
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| financials | array | yes | Normalized public financial-year records returned by the endpoint. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| identifier_type | string | yes | Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret). |
| name | string|null | yes | Publicly available company, person, buyer or record name for this result. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
| summary | object | yes | Compact derived summary of the returned records. |
No examples provided.
company_fr_history French Company Sirene History ~203
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 9-digit SIREN or 14-digit SIRET; a SIRET is normalized to its SIREN |
| Name | Type | Req | Description |
|---|---|---|---|
| current | object|null | yes | Structured value returned for “current” as defined by this API contract. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| identifier_type | string | yes | Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret). |
| periods | array | yes | Structured value returned for “periods” as defined by this API contract. |
| periods_count | integer | yes | Structured value returned for “periods count” as defined by this API contract. |
| siren | string | yes | Normalized 9-digit French SIREN when available. |
No examples provided.
company_fr_industrial_risk French Industrial Installation Risk ~204
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | French company identifier: 9-digit SIREN or 14-digit SIRET. |
| Name | Type | Req | Description |
|---|---|---|---|
| checked_at | string | yes | UTC timestamp at which HelpMyAgent performed the check. |
| communes_scanned | integer | yes | Structured value returned for “communes scanned” as defined by this API contract. |
| communes_total | integer | yes | Structured value returned for “communes total” as defined by this API contract. |
| coverage_complete | boolean | yes | Whether the checked public-source coverage was sufficient for the endpoint’s stated scope. |
| establishments_scanned | integer | yes | Structured value returned for “establishments scanned” as defined by this API contract. |
| establishments_total | integer|null | yes | Structured value returned for “establishments total” as defined by this API contract. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| headquarters_commune_code | string|null | yes | Structured value returned for “headquarters commune code” as defined by this API contract. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| installation_count | integer|null | yes | Structured value returned for “installation count” as defined by this API contract. |
| installations | array | yes | 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 | yes | Publicly available company, person, buyer or record name for this result. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
| source_status | string | yes | Availability status of the relevant upstream public source. (allowed values: ok, partial, unavailable, not_queried). |
No examples provided.
company_fr_intelligence French Company Intelligence ~332
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.
| Name | Type | Req | Description |
|---|---|---|---|
| domain | string | – | Optional domain used by the compliance section; it is not treated as an officially verified company domain. |
| identifier | string | yes | 9-digit SIREN or 14-digit SIRET |
| include | array | – | Optional list of existing Company sections to aggregate in the response |
| Name | Type | Req | Description |
|---|---|---|---|
| checked_at | string | yes | UTC timestamp at which HelpMyAgent performed the check. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| identifier_type | string | yes | Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret). |
| name | string|null | yes | Publicly available company, person, buyer or record name for this result. |
| sections | object | yes | Named result sections produced by this aggregator. |
| sections_available | array | yes | Structured value returned for “sections available” as defined by this API contract. |
| sections_requested | array | yes | Structured value returned for “sections requested” as defined by this API contract. |
| sections_unavailable | array | yes | Structured value returned for “sections unavailable” as defined by this API contract. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
No examples provided.
company_fr_invoice_check French Invoice Validation ~252
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| checked_at | string | yes | UTC timestamp at which HelpMyAgent performed the check. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| expected_vat_number | string|null | yes | Structured value returned for “expected vat number” as defined by this API contract. |
| format_match | boolean|null | yes | Structured value returned for “format match” as defined by this API contract. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| invoice_validation | object | yes | 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 | yes | Publicly available company, person, buyer or record name for this result. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
| supplied_vat_number | string|null | yes | Structured value returned for “supplied vat number” as defined by this API contract. |
| verdict | string | yes | Normalized endpoint conclusion derived from the checked public data. |
| vies_name | string|null | yes | Structured value returned for “vies name” as defined by this API contract. |
| vies_status | string | yes | Structured value returned for “vies status” as defined by this API contract. |
| vies_valid | boolean|null | yes | Structured value returned for “vies valid” as defined by this API contract. |
No examples provided.
company_fr_kyb_batch French Company KYB Batch ~288
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifiers | array | yes | 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). |
| Name | Type | Req | Description |
|---|---|---|---|
| checked_at | string | yes | UTC timestamp at which HelpMyAgent performed the check. |
| completed_count | integer | yes | Structured value returned for “completed count” as defined by this API contract. |
| failed_count | integer | yes | 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 | yes | Structured value returned for “requested count” as defined by this API contract. |
| results | array | yes | Structured result records returned by the endpoint. |
No examples provided.
company_fr_legal_announcements_search Search French BODACC announcements ~333
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| announcements | array | yes | Structured value returned for “announcements” as defined by this API contract. |
| criteria | object | yes | Structured value returned for “criteria” as defined by this API contract. |
| returned_count | integer | yes | Number of records included in this response. |
| total_count | integer | yes | Total number of matching records reported by the source or endpoint. |
| truncated | boolean | yes | Whether additional matching records existed beyond the returned result limit. |
No examples provided.
company_fr_lobbying French Lobbying Public Profile ~246
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | French company identifier: 9-digit SIREN or 14-digit SIRET. |
| Name | Type | Req | Description |
|---|---|---|---|
| activity_topics | array | yes | Structured value returned for “activity topics” as defined by this API contract. |
| checked_at | string | yes | UTC timestamp at which HelpMyAgent performed the check. |
| clients | array | yes | Structured value returned for “clients” as defined by this API contract. |
| declared_name | string|null | yes | Structured value returned for “declared name” as defined by this API contract. |
| domains | array | yes | Structured value returned for “domains” as defined by this API contract. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | 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 | yes | Publicly available company, person, buyer or record name for this result. |
| registered | boolean|null | yes | Structured value returned for “registered” as defined by this API contract. |
| registration_date | string|null | yes | Structured value returned for “registration date” as defined by this API contract. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
| source_json_url | string|null | yes | Structured value returned for “source json url” as defined by this API contract. |
| source_status | string | yes | Availability status of the relevant upstream public source. (allowed values: ok, unavailable, not_queried). |
No examples provided.
company_fr_nearby Nearby French companies ~379
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 | yes | 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). |
| Name | Type | Req | Description |
|---|---|---|---|
| activity_code | – | yes | Structured value returned for “activity code” as defined by this API contract. |
| activity_section | – | yes | Structured value returned for “activity section” as defined by this API contract. |
| companies | array | yes | Structured company records returned by the endpoint. |
| latitude | number | yes | Structured value returned for “latitude” as defined by this API contract. |
| longitude | number | yes | Structured value returned for “longitude” as defined by this API contract. |
| radius_km | number | yes | Structured value returned for “radius km” as defined by this API contract. |
| returned_count | integer | yes | Number of records included in this response. |
| total_count | integer | yes | Total number of matching records reported by the source or endpoint. |
| truncated | boolean | yes | Whether additional matching records existed beyond the returned result limit. |
No examples provided.
company_fr_new New French Companies ~274
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 |
| Name | Type | Req | Description |
|---|---|---|---|
| companies | array | yes | Structured company records returned by the endpoint. |
| cursor | string | yes | Structured value returned for “cursor” as defined by this API contract. |
| limit | integer | yes | Structured value returned for “limit” as defined by this API contract. |
| next_cursor | string|null | yes | Structured value returned for “next cursor” as defined by this API contract. |
| returned_count | integer | yes | Number of records included in this response. |
| since | string | yes | Structured value returned for “since” as defined by this API contract. |
| total_count | integer | yes | Total number of matching records reported by the source or endpoint. |
| truncated | boolean | yes | Whether additional matching records existed beyond the returned result limit. |
| until | string | yes | Structured value returned for “until” as defined by this API contract. |
No examples provided.
company_fr_opportunities French Company Opportunities ~291
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 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 |
| Name | Type | Req | Description |
|---|---|---|---|
| company_status | string|null | yes | Current public administrative company status when available. |
| coverage | array | yes | Coverage information describing which underlying services or sources were available. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| identifier_type | string | yes | 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 | yes | Publicly available company, person, buyer or record name for this result. |
| opportunities | array | yes | Ranked public-data opportunities returned by the endpoint. |
| project | string|null | yes | Structured value returned for “project” as defined by this API contract. |
| returned_count | integer | yes | Number of records included in this response. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
| total_candidates | integer | yes | Structured value returned for “total candidates” as defined by this API contract. |
| truncated | boolean | yes | Whether additional matching records existed beyond the returned result limit. |
No examples provided.
company_fr_payment_context Payment context for a French company ~283
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.
| Name | Type | Req | Description |
|---|---|---|---|
| domain | string | – | Optional domain supplied as additional counterparty context; it is checked separately and is not treated as proof of company ownership. |
| identifier | string | yes | French company identifier: 9-digit SIREN or 14-digit SIRET. |
| Name | Type | Req | Description |
|---|---|---|---|
| checked_at | string | yes | UTC timestamp at which HelpMyAgent performed the check. |
| collective_procedure_events | integer|null | yes | Structured value returned for “collective procedure events” as defined by this API contract. |
| company_status | – | yes | Current public administrative company status when available. |
| compliance_status | string | yes | Structured value returned for “compliance status” as defined by this API contract. |
| coverage | array | yes | Coverage information describing which underlying services or sources were available. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| identifier_type | string | yes | Normalized identifier type, such as SIREN or SIRET when applicable. |
| latest_relevant_event | – | yes | Structured value returned for “latest relevant event” as defined by this API contract. |
| legal_risk | – | yes | 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 | – | yes | Publicly available company, person, buyer or record name for this result. |
| public_alerts_found | boolean|null | yes | Structured value returned for “public alerts found” as defined by this API contract. |
| radiation_events | integer|null | yes | Structured value returned for “radiation events” as defined by this API contract. |
| siren | – | yes | Normalized 9-digit French SIREN when available. |
No examples provided.
company_fr_peers Comparable French companies ~305
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 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). |
| Name | Type | Req | Description |
|---|---|---|---|
| criteria | object | yes | Structured value returned for “criteria” as defined by this API contract. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| name | – | yes | Publicly available company, person, buyer or record name for this result. |
| peers | array | yes | Structured value returned for “peers” as defined by this API contract. |
| scope | string | yes | Structured value returned for “scope” as defined by this API contract. |
| siren | – | yes | Normalized 9-digit French SIREN when available. |
No examples provided.
company_fr_profile French Company Profile ~244
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 9-digit SIREN or 14-digit SIRET |
| Name | Type | Req | Description |
|---|---|---|---|
| activity_code | string|null | yes | Structured value returned for “activity code” as defined by this API contract. |
| closure_date | string|null | yes | Structured value returned for “closure date” as defined by this API contract. |
| company_category | string|null | yes | Structured value returned for “company category” as defined by this API contract. |
| creation_date | string|null | yes | Structured value returned for “creation date” as defined by this API contract. |
| employee_band_code | string|null | yes | Structured value returned for “employee band code” as defined by this API contract. |
| employee_band_year | string|null | yes | Structured value returned for “employee band year” as defined by this API contract. |
| establishments_count | integer|null | yes | Structured value returned for “establishments count” as defined by this API contract. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| headquarters | object|null | yes | Structured value returned for “headquarters” as defined by this API contract. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| identifier_type | string | yes | Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret). |
| is_employer | boolean|null | yes | Structured value returned for “is employer” as defined by this API contract. |
| legal_form_code | string|null | yes | Structured value returned for “legal form code” as defined by this API contract. |
| name | string|null | yes | Publicly available company, person, buyer or record name for this result. |
| open_establishments_count | integer|null | yes | Structured value returned for “open establishments count” as defined by this API contract. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
| status | string|null | yes | Normalized endpoint or source status. |
No examples provided.
company_fr_prospecting French B2B company prospecting ~531
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| companies | array | yes | Structured company records returned by the endpoint. |
| filters | object | yes | Structured value returned for “filters” as defined by this API contract. |
| limit | integer | yes | Structured value returned for “limit” as defined by this API contract. |
| page | integer | yes | Structured value returned for “page” as defined by this API contract. |
| returned_count | integer | yes | Number of records included in this response. |
| total_count | integer | yes | Total number of matching records reported by the source or endpoint. |
| truncated | boolean | yes | Whether additional matching records existed beyond the returned result limit. |
No examples provided.
company_fr_public_contract_competitors Public-contract competitors ~290
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 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). |
| Name | Type | Req | Description |
|---|---|---|---|
| competitors | array | yes | Structured value returned for “competitors” as defined by this API contract. |
| cpv_segments | array | yes | Structured value returned for “cpv segments” as defined by this API contract. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| name | – | yes | Publicly available company, person, buyer or record name for this result. |
| siren | – | yes | Normalized 9-digit French SIREN when available. |
No examples provided.
company_fr_public_contracts French Company Public Contracts ~249
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 9-digit SIREN or 14-digit SIRET |
| limit | integer | – | Maximum number of awarded public contracts to return |
| Name | Type | Req | Description |
|---|---|---|---|
| contracts | array | yes | Normalized public-contract records returned by the endpoint. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| identifier_type | string | yes | Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret). |
| name | string|null | yes | Publicly available company, person, buyer or record name for this result. |
| returned_count | integer | yes | Number of records included in this response. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
| summary | object | yes | Compact derived summary of the returned records. |
| total_count | integer | yes | Total number of matching records reported by the source or endpoint. |
| truncated | boolean | yes | Whether additional matching records existed beyond the returned result limit. |
No examples provided.
company_fr_public_contracts_eu French Company EU Public Contracts ~296
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 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). |
| Name | Type | Req | Description |
|---|---|---|---|
| checked_at | string | yes | UTC timestamp at which HelpMyAgent performed the check. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| identifier | string | yes | 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 | yes | Publicly available company, person, buyer or record name for this result. |
| notices | array | yes | Structured value returned for “notices” as defined by this API contract. |
| returned_count | integer|null | yes | Number of records included in this response. |
| search_query | string|null | yes | Structured value returned for “search query” as defined by this API contract. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
| source_status | string | yes | Availability status of the relevant upstream public source. (allowed values: ok, unavailable, not_queried). |
No examples provided.
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.