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_regulatory_approvals French Financial Regulatory Approvals ~259
Checks a French company against the public REGAFI register and normalizes matching regulatory records. Use when: Check whether a French company appears in the public REGAFI register. You need to know whether a French company appears in the public REGAFI register and inspect normalized matching records. You specifically need financial-regulatory registration signals rather than general company compliance. Avoid when: You want public alerts plus a REGAFI registration summary; use company/fr/compliance. You need general sanctions or asset-freeze screening; use company/fr/compliance. Limitations: Coverage is limited to the public REGAFI source used by the endpoint. No REGAFI match is not a universal statement that an entity is unregulated in every jurisdiction or activity. Price: 0.020 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | French company identifier: 9-digit SIREN or 14-digit SIRET. |
| Name | Type | Req | Description |
|---|---|---|---|
| approval_count | integer|null | yes | Structured value returned for “approval count” as defined by this API contract. |
| approvals | array | yes | Structured value returned for “approvals” as defined by this API contract. |
| 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. |
| regulated | boolean|null | yes | Structured value returned for “regulated” 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.
company_fr_report French Company PDF Report ~267
Generates a simple PDF rendition of selected HelpMyAgent public company intelligence. Use when: Generate a portable PDF summary for a French company. You need a portable PDF summary of selected HelpMyAgent public company intelligence. You need a human-readable artifact in French or English rather than only structured JSON. Avoid when: You need structured data for downstream automation; use company/fr/intelligence or a dedicated endpoint. You only need a written risk interpretation; use company/fr/risk-reading. Limitations: The PDF reflects the public-data sections available when it is generated and does not add independent factual coverage. It is an informational report, not an audit, legal opinion or regulated credit report. Price: 0.075 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | French company identifier: 9-digit SIREN or 14-digit SIRET. |
| language | string | – | Language used for the generated human-readable output. (default fr; allowed values: fr, en). |
| Name | Type | Req | Description |
|---|---|---|---|
| bytes | integer | yes | Structured value returned for “bytes” as defined by this API contract. |
| filename | string | yes | Structured value returned for “filename” as defined by this API contract. |
| generated_at | string | yes | UTC timestamp at which this derived result was generated. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| language | string | yes | Structured value returned for “language” as defined by this API contract. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| mime_type | string | yes | Structured value returned for “mime type” as defined by this API contract. |
| pdf_base64 | string | yes | Structured value returned for “pdf base64” as defined by this API contract. |
| sections | object | yes | Named result sections produced by this aggregator. |
| sha256 | string | yes | Structured value returned for “sha256” as defined by this API contract. |
No examples provided.
company_fr_risk French Company Legal Risk ~264
Detects public legal-risk signals for a French company from company status and BODACC notices, including insolvency proceedings and deregistrations. This is not a credit score. Use when: You need explainable public legal-risk signals for a French company, including insolvency proceedings, deregistrations and administrative closure. You need a normalized low, warning, high or unknown legal-risk level backed by public events. Avoid when: You need a credit score, probability of default, payment behavior or bank-grade solvency assessment. You need sanctions or regulatory blacklist screening; use company/fr/compliance. Limitations: The BODACC analysis uses a 10-year lookback and reports when source coverage is insufficient to conclude. This is a public legal-risk signal service, not a credit score or legal opinion. Price: 0.010 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 9-digit SIREN or 14-digit SIRET |
| Name | Type | Req | Description |
|---|---|---|---|
| assessment_basis | string | yes | Structured value returned for “assessment basis” as defined by this API contract. |
| company_status | string|null | yes | Current public administrative company status when available. |
| coverage_complete | boolean|null | yes | Whether the checked public-source coverage was sufficient for the endpoint’s stated scope. |
| 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. |
| lookback_years | integer | yes | Structured value returned for “lookback years” as defined by this API contract. |
| name | string|null | yes | Publicly available company, person, buyer or record name for this result. |
| risk_level | string|null | yes | Explainable public-data risk level produced by this endpoint; it is not an official credit score. (allowed values: low, warning, high, unknown). |
| signals | object | yes | Structured value returned for “signals” as defined by this API contract. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
No examples provided.
company_fr_risk_reading French Company Risk Reading ~275
Turns existing public risk, legal, financial and signal data into a concise written reading. Use when: Get a written public-data risk reading for a French company. You need a concise human-readable interpretation of existing public risk, legal, financial and signal data. You want strengths, alerts and evidence summarized in French or English. Avoid when: You need structured legal-risk events and level only; use company/fr/risk. You need the deterministic public-data default indicator and components; use company/fr/default-score. Limitations: The narrative is derived from existing HelpMyAgent public-data results and does not create new source evidence. It is informational and must not be treated as a regulated credit or legal decision. Price: 0.030 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | French company identifier: 9-digit SIREN or 14-digit SIRET. |
| language | string | – | Language used for the generated human-readable output. (default fr; allowed values: fr, en). |
| Name | Type | Req | Description |
|---|---|---|---|
| alerts | array | yes | Structured value returned for “alerts” as defined by this API contract. |
| confidence | string|null | yes | Confidence indicator associated with an inferred or derived result. |
| evidence | object | yes | Structured value returned for “evidence” as defined by this API contract. |
| exists | boolean | yes | Whether the requested company or public record was found in the checked source. |
| generated_at | string | yes | UTC timestamp at which this derived result was generated. |
| identifier | string | yes | Identifier supplied for the request, echoed in normalized form when applicable. |
| language | string | yes | Structured value returned for “language” as defined by this API contract. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| name | string|null | yes | Publicly available company, person, buyer or record name for this result. |
| narrative | string | yes | Structured value returned for “narrative” as defined by this API contract. |
| score | number|null | yes | Normalized score produced by the endpoint; interpretation is defined by the tool description and limitations. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
| strengths | array | yes | Structured value returned for “strengths” as defined by this API contract. |
| verdict | string | yes | Normalized endpoint conclusion derived from the checked public data. |
No examples provided.
company_fr_search French Company Search ~291
Searches French companies by name, SIREN, SIRET or optional location criteria and returns structured matching company records. Use when: You need to find a French company or establishment from a name, legal name, SIREN or SIRET. You need candidate company identifiers before calling a more specialized Company endpoint. Avoid when: You already have an exact SIREN or SIRET and only need to verify existence or administrative status; use company/fr/verify. You need detailed profile, financial, legal-risk or compliance data; use the specialized endpoint or company/fr/intelligence. Limitations: Matching quality and result ordering depend on the public company-search source and the ambiguity of the query. The response is a search result set, not a complete company dossier. Price: 0.002 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum number of matching companies to return |
| postal_code | string | – | Optional French postal code used to narrow the search |
| query | string | yes | Company name, legal name, SIREN or SIRET to search for |
| Name | Type | Req | Description |
|---|---|---|---|
| results | array | yes | Structured result records returned by the endpoint. |
No examples provided.
company_fr_sector_statistics French Company Sector Statistics ~325
Returns the source-reported active-company count for a French NAF activity plus explicit descriptive samples for age, workforce bands and optional financials; large counts can be capped at 10,000 by the source. Use when: Measure the source-reported active-company count for a French NAF activity and obtain descriptive sample statistics. Avoid when: You need an official INSEE statistical publication rather than statistics computed from company records. Limitations: The Recherche d'entreprises search engine caps large total-result counts at 10,000. When total_active is 10000, total_active_is_exact is false and the true count is at least 10,000. Age, workforce-band and financial distributions remain explicitly sampled. When the total count is capped, sample_coverage_percent is an upper bound. Price: 0.020 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| activity_code | string | yes | French NAF activity code to summarize, in the form 00.00A. |
| department | string | – | Optional French department code used to restrict results geographically. |
| include_financials | boolean | – | When true, include the supported public financial sample in the sector statistics. (default false). |
| region | string | – | Optional French region code used to restrict results geographically. |
| Name | Type | Req | Description |
|---|---|---|---|
| activity_code | string | yes | Structured value returned for “activity code” as defined by this API contract. |
| age_years | object | yes | Structured value returned for “age years” as defined by this API contract. |
| department | string|null | yes | Structured value returned for “department” as defined by this API contract. |
| employee_band_distribution | array | yes | Structured value returned for “employee band distribution” as defined by this API contract. |
| financial_sample_count | integer | yes | Structured value returned for “financial sample count” as defined by this API contract. |
| generated_at | string | yes | UTC timestamp at which this derived result was generated. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| median_net_income | number|integer|null | yes | Structured value returned for “median net income” as defined by this API contract. |
| median_revenue | number|integer|null | yes | Structured value returned for “median revenue” as defined by this API contract. |
| region | string|null | yes | Structured value returned for “region” as defined by this API contract. |
| sample_coverage_percent | number | yes | Structured value returned for “sample coverage percent” as defined by this API contract. |
| sample_limit | integer | yes | Structured value returned for “sample limit” as defined by this API contract. |
| sampled_count | integer | yes | Structured value returned for “sampled count” as defined by this API contract. |
| total_active | integer | yes | Structured value returned for “total active” as defined by this API contract. |
| total_active_is_exact | boolean | yes | Structured value returned for “total active is exact” as defined by this API contract. |
No examples provided.
company_fr_signals French Company Signals ~268
Detects explainable business signals from available French company data, including closure, insolvency, revenue changes, new filings, public contracts and certifications. Use when: You need explainable business signals derived from existing public Company data rather than raw records from one source. You want to detect supported signals such as closure, insolvency, revenue change, new financial filings, public contracts or certifications. Avoid when: You need the underlying raw financial, BODACC, contract or certification records; call the specialized endpoint instead. You need continuous monitoring or push alerts; this endpoint evaluates signals at request time and is not a subscription service. Limitations: Only the signal families explicitly implemented by the endpoint are evaluated; it is not a general predictive business-risk model. Coverage can be partial when one of the underlying public-data services is unavailable. Price: 0.020 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
| 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). |
| lookback_days | integer | yes | Structured value returned for “lookback days” as defined by this API contract. |
| name | string|null | yes | Publicly available company, person, buyer or record name for this result. |
| signals | array | yes | Structured value returned for “signals” as defined by this API contract. |
| signals_count | integer | yes | Structured value returned for “signals count” as defined by this API contract. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
No examples provided.
company_fr_successions French Establishment Successions ~275
Returns official Sirene predecessor and successor links for a French establishment, with effective date, headquarters-transfer flag and economic-continuity flag. Use when: You need official predecessor or successor establishment links for a French SIRET. Avoid when: You only need the current establishments of a company; use company/fr/establishments. Limitations: Succession links are declaration-based and INSEE explicitly states that not every real-world succession is necessarily known. Predecessor and successor cursors are independent and must only be reused for the same SIRET and direction. Price: 0.010 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum predecessor and successor links per direction, up to 100 |
| predecessors_cursor | string | – | Opaque cursor returned by predecessors_next_cursor; omit on the first call |
| siret | string | yes | 14-digit French SIRET |
| successors_cursor | string | – | Opaque cursor returned by successors_next_cursor; omit on the first call |
| Name | Type | Req | Description |
|---|---|---|---|
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| predecessors | array | yes | Structured value returned for “predecessors” as defined by this API contract. |
| predecessors_count | integer | yes | Structured value returned for “predecessors count” as defined by this API contract. |
| predecessors_cursor | string | yes | Structured value returned for “predecessors cursor” as defined by this API contract. |
| predecessors_next_cursor | string|null | yes | Structured value returned for “predecessors next cursor” as defined by this API contract. |
| predecessors_returned_count | integer | yes | Structured value returned for “predecessors returned count” as defined by this API contract. |
| predecessors_truncated | boolean | yes | Structured value returned for “predecessors truncated” as defined by this API contract. |
| siren | string | yes | Normalized 9-digit French SIREN when available. |
| siret | string | yes | Normalized 14-digit French SIRET when available. |
| successors | array | yes | Structured value returned for “successors” as defined by this API contract. |
| successors_count | integer | yes | Structured value returned for “successors count” as defined by this API contract. |
| successors_cursor | string | yes | Structured value returned for “successors cursor” as defined by this API contract. |
| successors_next_cursor | string|null | yes | Structured value returned for “successors next cursor” as defined by this API contract. |
| successors_returned_count | integer | yes | Structured value returned for “successors returned count” as defined by this API contract. |
| successors_truncated | boolean | yes | Structured value returned for “successors truncated” as defined by this API contract. |
No examples provided.
company_fr_supplier_verification French Supplier Verification ~295
Combines public company, compliance and optional VAT/IBAN consistency checks into a supplier review result. Use when: Review a French supplier before onboarding or payment. You need a compact pre-onboarding or pre-payment review of a French supplier using public company/compliance data plus optional VAT and IBAN checks. You want one normalized supplier verdict while retaining the individual check results. Avoid when: You need a broader multi-section company dossier; use company/fr/intelligence. You only need to compare invoice identifiers and VAT information; use company/fr/invoice-check. Limitations: IBAN validation is structural and does not prove bank-account ownership by the supplier. The result is public-data decision support, not a guarantee that a supplier or payment is fraud-free. Price: 0.050 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| iban | string | – | IBAN supplied for structural validation or supplier consistency checks. |
| identifier | string | yes | French company identifier: 9-digit SIREN or 14-digit SIRET. |
| vat_number | string | – | Optional or required VAT identifier used by this validation or consistency check. |
| Name | Type | Req | Description |
|---|---|---|---|
| checked_at | string | yes | UTC timestamp at which HelpMyAgent performed the check. |
| checks | object | yes | Structured value returned for “checks” as defined by this API contract. |
| 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. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
| verdict | string | yes | Normalized endpoint conclusion derived from the checked public data. |
No examples provided.
company_fr_verify French Company Verification ~248
Verifies the existence and current status of a French company or establishment from a SIREN or SIRET. Use when: You have a French SIREN or SIRET and need to confirm that the company or establishment exists in the public source. You need its current administrative active/closed status before another automated step. Avoid when: You only have a company name and need to discover its identifier; use company/fr/search. You need directors, financials, legal risk or compliance checks; use the corresponding specialized endpoint. Limitations: This verifies public administrative existence and status only; it is not KYC, identity assurance or beneficial-owner verification. Returned fields depend on what the public company source exposes for the identifier. Price: 0.005 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| identifier | string | yes | 9-digit SIREN or 14-digit SIRET |
| Name | Type | Req | Description |
|---|---|---|---|
| active | boolean|null | yes | Current public administrative active status when available. |
| activity_code | string|null | yes | Structured value returned for “activity code” as defined by this API contract. |
| address | string|null | yes | Structured value returned for “address” as defined by this API contract. |
| city | string|null | yes | Structured value returned for “city” 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. |
| postal_code | string|null | yes | Structured value returned for “postal code” as defined by this API contract. |
| siren | string|null | yes | Normalized 9-digit French SIREN when available. |
| siret | string|null | yes | Normalized 14-digit French SIRET when available. |
No examples provided.
compliance_name_screen Public Sanctions Name Screen ~307
Screens a name against integrated French, UK and UN public sanctions/freezing lists using explainable fuzzy matching. Use when: Screen a person or organization name against public sanctions lists. You have a person or organization name and need explainable screening against the supported French, UK and UN public sanctions lists. You need candidate matches with fuzzy-match scores before manual review. Avoid when: You have a French company identifier and want company-aware public compliance checks; use company/fr/compliance. You need a complete commercial AML/KYC database or a legal guarantee that a subject is unsanctioned. Limitations: Fuzzy name matching can produce false positives and false negatives, especially for aliases, transliteration and common names. No match means only that no candidate was found in the supported public lists at check time. Price: 0.020 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | Person or organization name to compare with the supported public sanctions and asset-freeze lists. (minimum length 2; maximum length 200). |
| threshold | integer | – | Minimum fuzzy-match score accepted as a candidate public-list match. (minimum 50; maximum 100; default 85). |
| Name | Type | Req | Description |
|---|---|---|---|
| checked_at | string | yes | UTC timestamp at which HelpMyAgent performed the check. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| match_count | integer | yes | Number of candidate matches returned by the screening operation. |
| matches | array | yes | Candidate public-list or source matches returned by the endpoint. |
| name | string | yes | Publicly available company, person, buyer or record name for this result. |
| sources | array | yes | Public data sources used or checked for this result. |
| status | string | yes | Normalized endpoint or source status. |
| threshold | integer | yes | Structured value returned for “threshold” as defined by this API contract. |
No examples provided.
describe_api Describe a HelpMyAgent API ~76
Inspect metadata for one published HelpMyAgent endpoint without executing or charging for it. Returns the exact method, executable URL, input/output schemas, price, coverage, provenance, examples and documentation for a canonical endpoint slug.
| Name | Type | Req | Description |
|---|---|---|---|
| endpoint | string | yes | Canonical published HelpMyAgent endpoint slug. Accepted values are restricted to the live published catalogue. |
Structured output declared, but exposes no named fields.
No examples provided.
iban_validate IBAN Structure Validation ~278
Validates IBAN structure and mod-97 checksum locally and extracts French bank/branch/account components when present. Use when: Validate an IBAN checksum before using it in a workflow. You need local IBAN normalization, structural validation and mod-97 checksum verification before using an account identifier. For French IBANs, you also want the available bank, branch, account and RIB-key components. Avoid when: You need to verify that an IBAN belongs to a specific supplier; structural validation cannot establish ownership. You need supplier-level public identity/compliance context; use company/fr/supplier-verification. Limitations: A checksum-valid IBAN can still refer to a closed, nonexistent or unrelated bank account. Bank/BIC enrichment is returned only when supported by the endpoint’s available reference data. Price: 0.002 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| iban | string | yes | IBAN to normalize and validate structurally, including the ISO 13616 mod-97 checksum. (minimum length 15; maximum length 34). |
| Name | Type | Req | Description |
|---|---|---|---|
| account_number | string|null | yes | Structured value returned for “account number” as defined by this API contract. |
| bank_code | string|null | yes | Structured value returned for “bank code” as defined by this API contract. |
| bank_name | string|null | yes | Structured value returned for “bank name” as defined by this API contract. |
| bic | string|null | yes | Structured value returned for “bic” as defined by this API contract. |
| branch_code | string|null | yes | Structured value returned for “branch code” as defined by this API contract. |
| checked_at | string | yes | UTC timestamp at which HelpMyAgent performed the check. |
| checksum_valid | boolean | yes | Structured value returned for “checksum valid” as defined by this API contract. |
| country_code | string | yes | Structured value returned for “country code” as defined by this API contract. |
| expected_length | integer|null | yes | Structured value returned for “expected length” as defined by this API contract. |
| iban | string | yes | Structured value returned for “iban” as defined by this API contract. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| rib_key | string|null | yes | Structured value returned for “rib key” as defined by this API contract. |
| structure_valid | boolean | yes | Structured value returned for “structure valid” as defined by this API contract. |
| valid | boolean | yes | Whether the supplied identifier passed the endpoint’s validation rules. |
No examples provided.
list_categories List HelpMyAgent API categories ~52
List public HelpMyAgent API categories and the number of published endpoints in each category without executing or charging for an API call. Returns category slugs, names, endpoint counts and documentation links. This tool takes no arguments.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| categories | array | yes | Published HelpMyAgent API categories with endpoint counts and documentation links. |
No examples provided.
procurement_fr_awards French Public Contract Awards ~389
Searches awarded French public contracts using DECP filters for CPV, location, buyer, holder, dates and amounts. Use when: Search French public contracts that have already been awarded using CPV, location, buyer, holder, date or amount filters. Avoid when: Use procurement/fr/search for currently open BOAMP tenders. Use company/fr/public-contracts when you only need contracts awarded to one known French company. Limitations: Coverage follows the published DECP dataset and source fields. Price: 0.010 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| buyer | string | – | Public-buyer name or identifier used to restrict procurement results. (minimum length 2; maximum length 200). |
| cpv_prefix | string | – | Optional CPV prefix used to restrict procurement records to a purchasing segment. |
| date_from | string | – | Optional value for “date from” as defined by this API contract. |
| date_to | string | – | Optional value for “date to” as defined by this API contract. |
| department | string | – | Optional French department code used to restrict results geographically. |
| holder | string | – | Optional value for “holder” as defined by this API contract. |
| limit | integer | – | Maximum number of records returned by this call. (minimum 1; maximum 50; default 20). |
| max_amount | number | – | Optional value for “max amount” as defined by this API contract. (minimum 0). |
| min_amount | number | – | Optional value for “min amount” as defined by this API contract. (minimum 0). |
| Name | Type | Req | Description |
|---|---|---|---|
| awards | array | yes | Structured value returned for “awards” as defined by this API contract. |
| filters | object | yes | Structured value returned for “filters” as defined by this API contract. |
| generated_at | string | yes | UTC timestamp at which this derived result was generated. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| returned_count | integer|null | yes | Number of records included in this response. |
| source_status | string | yes | Availability status of the relevant upstream public source. (allowed values: ok, unavailable). |
| total_count | integer|null | yes | Total number of matching records reported by the source or endpoint. |
| truncated | boolean|null | yes | Whether additional matching records existed beyond the returned result limit. |
No examples provided.
procurement_fr_buyer_profile French Public Buyer Profile ~291
Builds a compact DECP profile for a French public buyer by name or SIRET. Use when: Profile a French public buyer from its published contract records. You need a compact historical procurement profile for a French public buyer identified by name or SIRET. You want published award volume, recent activity, top CPV segments and frequent suppliers from DECP data. Avoid when: You need currently open tenders from that buyer; use procurement/fr/search. You need one supplier’s awarded-contract history; use company/fr/public-contracts. Limitations: The profile is derived from the sampled/public DECP award records matched to the buyer query. Published contract records do not represent every purchasing activity or off-contract expenditure of the buyer. Price: 0.020 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| buyer | string | yes | French public-buyer name or SIRET used to build the procurement profile. (minimum length 2; maximum length 200). |
| limit | integer | – | Maximum number of records returned by this call. (minimum 1; maximum 100; default 100). |
| Name | Type | Req | Description |
|---|---|---|---|
| buyer_name | string|null | yes | Structured value returned for “buyer name” as defined by this API contract. |
| buyer_siret | string|null | yes | Structured value returned for “buyer siret” as defined by this API contract. |
| by_year | array | yes | Structured value returned for “by year” as defined by this API contract. |
| generated_at | string | yes | UTC timestamp at which this derived result was generated. |
| latest_notification_date | string|null | yes | Structured value returned for “latest notification date” as defined by this API contract. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| query | string | yes | Structured value returned for “query” as defined by this API contract. |
| sampled_amount | number|integer|null | yes | Structured value returned for “sampled amount” as defined by this API contract. |
| sampled_count | integer|null | yes | Structured value returned for “sampled count” as defined by this API contract. |
| source_status | string | yes | Availability status of the relevant upstream public source. (allowed values: ok, unavailable). |
| top_cpv | array | yes | Structured value returned for “top cpv” as defined by this API contract. |
| top_suppliers | array | yes | Structured value returned for “top suppliers” as defined by this API contract. |
| total_count | integer|null | yes | Total number of matching records reported by the source or endpoint. |
No examples provided.
procurement_fr_deadlines French Public Contract Expiry & Renewal Signals ~335
Estimates upcoming public-contract end dates using DECP notification, initial duration and published duration modifications, with an explicit confidence level. Use when: Find French public contracts likely to expire or renew soon, taking published DECP duration modifications into account. Avoid when: You need open tenders rather than awarded-contract expiry signals; use procurement/fr/search. Limitations: End dates remain estimates; confidence is reduced when DECP reports a modification without a revised duration. Malformed or non-date DECP modification fields are ignored and an isolated modification identifier no longer creates a modification signal by itself. Price: 0.010 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| cpv_prefix | string | – | Optional CPV code prefix used to restrict public-contract expiry estimates to a procurement segment. |
| department | string | – | Optional French department code used to restrict results geographically. |
| limit | integer | – | Maximum number of records returned by this call. (minimum 1; maximum 50; default 25). |
| max_months | integer | – | Maximum number of months from now before the estimated contract end date. (minimum 1; maximum 60; default 18). |
| min_months | integer | – | Minimum number of months from now before the estimated contract end date. (minimum 0; maximum 60; default 0). |
| Name | Type | Req | Description |
|---|---|---|---|
| contracts | array | yes | Normalized public-contract records returned by the endpoint. |
| cpv_prefix | string|null | yes | Structured value returned for “cpv prefix” as defined by this API contract. |
| department | string|null | yes | Structured value returned for “department” as defined by this API contract. |
| generated_at | string | yes | UTC timestamp at which this derived result was generated. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| max_months | integer | yes | Structured value returned for “max months” as defined by this API contract. |
| min_months | integer | yes | Structured value returned for “min months” as defined by this API contract. |
| returned_count | integer|null | yes | Number of records included in this response. |
| source_status | string | yes | Availability status of the relevant upstream public source. (allowed values: ok, unavailable). |
No examples provided.
procurement_fr_market French Public Procurement Market ~285
Summarizes the size and structure of a French public-procurement segment from awarded DECP contracts. Use when: Measure the size and structure of a French public-procurement segment over a recent time window. Avoid when: Use procurement/fr/awards when you need individual awarded-contract records. Use procurement/fr/buyer-profile when the question is specifically about one public buyer. Limitations: Supplier ranking is based on the latest 100 matching awards; its sample coverage is returned explicitly. Price: 0.020 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| buyer | string | – | Public-buyer name or identifier used to restrict procurement results. (minimum length 2; maximum length 200). |
| cpv_prefix | string | – | Optional CPV prefix used to restrict procurement records to a purchasing segment. |
| department | string | – | Optional French department code used to restrict results geographically. |
| lookback_months | integer | – | Optional value for “lookback months” as defined by this API contract. (minimum 1; maximum 60; default 12). |
| Name | Type | Req | Description |
|---|---|---|---|
| filters | object | yes | Structured value returned for “filters” as defined by this API contract. |
| generated_at | string | yes | UTC timestamp at which this derived result was generated. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| lookback_months | integer | yes | Structured value returned for “lookback months” as defined by this API contract. |
| source_status | string | yes | Availability status of the relevant upstream public source. (allowed values: ok, partial, unavailable). |
| summary | object | yes | Compact derived summary of the returned records. |
| supplier_sample_coverage_percent | number|integer|null | yes | Structured value returned for “supplier sample coverage percent” as defined by this API contract. |
| supplier_sampled_count | integer|null | yes | Structured value returned for “supplier sampled count” as defined by this API contract. |
| top_buyers | array | yes | Structured value returned for “top buyers” as defined by this API contract. |
| top_cpv | array | yes | Structured value returned for “top cpv” as defined by this API contract. |
| top_suppliers_in_latest_sample | array | yes | Structured value returned for “top suppliers in latest sample” as defined by this API contract. |
No examples provided.
procurement_fr_search French Public Procurement Search ~291
Searches currently open French public procurement opportunities and returns normalized BOAMP tender data ready for automated processing. Use when: You need currently open French public procurement opportunities from BOAMP. You want to search open tenders by keywords, department, buyer or minimum deadline. Avoid when: You need contracts already awarded to a specific company; use company/fr/public-contracts. You need private procurement opportunities or a guarantee that every French public procurement notice is covered. Limitations: Coverage is limited to the BOAMP public dataset and the notices available through that source. At least one of query, department or buyer is required; tender deadlines and notice details can change at the source. Price: 0.010 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| buyer | string | – | Public buyer name to search for |
| deadline_after | string | – | Only return tenders whose deadline is on or after this YYYY-MM-DD date |
| department | string | – | French department code |
| limit | integer | – | Maximum number of open tenders to return |
| query | string | – | Keywords to search in currently open public procurement notices |
| Name | Type | Req | Description |
|---|---|---|---|
| buyer | string|null | yes | Structured value returned for “buyer” as defined by this API contract. |
| deadline_after | string|null | yes | Structured value returned for “deadline after” as defined by this API contract. |
| department | string|null | yes | Structured value returned for “department” as defined by this API contract. |
| query | string|null | yes | Structured value returned for “query” as defined by this API contract. |
| returned_count | integer | yes | Number of records included in this response. |
| tenders | array | yes | Normalized open public-procurement notices returned by the endpoint. |
| 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.
procurement_fr_trends French Public Procurement Trends ~302
Builds monthly or yearly time series of awarded French public-contract volumes and amounts from DECP. Use when: Track how French awarded public-contract volumes and amounts evolve month by month or year by year. Avoid when: Use procurement/fr/market for a current segment overview without a time series. Use procurement/fr/search for open tender opportunities. Limitations: The current partial month or year can mechanically reduce the latest period. Price: 0.020 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| buyer | string | – | Public-buyer name or identifier used to restrict procurement results. (minimum length 2; maximum length 200). |
| cpv_prefix | string | – | Optional CPV prefix used to restrict procurement records to a purchasing segment. |
| department | string | – | Optional French department code used to restrict results geographically. |
| granularity | string | – | Optional value for “granularity” as defined by this API contract. (default month; allowed values: month, year). |
| lookback_months | integer | – | Optional value for “lookback months” as defined by this API contract. (minimum 1; maximum 60; default 24). |
| Name | Type | Req | Description |
|---|---|---|---|
| filters | object | yes | Structured value returned for “filters” as defined by this API contract. |
| generated_at | string | yes | UTC timestamp at which this derived result was generated. |
| granularity | string | yes | Structured value returned for “granularity” as defined by this API contract. (allowed values: month, year). |
| latest_period_contracts_change_percent | number|integer|null | yes | Structured value returned for “latest period contracts change percent” as defined by this API contract. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| lookback_months | integer | yes | Structured value returned for “lookback months” as defined by this API contract. |
| periods_count | integer|null | yes | Structured value returned for “periods count” as defined by this API contract. |
| series | array | yes | Structured value returned for “series” as defined by this API contract. |
| source_status | string | yes | Availability status of the relevant upstream public source. (allowed values: ok, unavailable). |
No examples provided.
real_estate_fr_dpe French Property DPE ~237
Finds ADEME energy-performance certificates for an address or French municipality. Use when: Find residential DPE records for a French address or municipality. Avoid when: An address can contain several dwellings and therefore several DPE records. Limitations: ADEME republishes data submitted by diagnosticians; an address match does not guarantee identification of the exact dwelling. Price: 0.010 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | – | Optional value for “address” as defined by this API contract. (minimum length 5; maximum length 250). |
| code_insee | string | – | Optional value for “code insee” as defined by this API contract. |
| limit | integer | – | Maximum number of records returned by this call. (minimum 1; maximum 50; default 10). |
| Name | Type | Req | Description |
|---|---|---|---|
| dpe | array | yes | Structured value returned for “dpe” as defined by this API contract. |
| generated_at | string | yes | UTC timestamp at which this derived result was generated. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| location | object | yes | Structured value returned for “location” as defined by this API contract. |
| returned_count | integer|null | yes | Number of records included in this response. |
| source_status | string | yes | Availability status of the relevant upstream public source. (allowed values: ok). |
| total_count | integer|null | yes | Total number of matching records reported by the source or endpoint. |
| truncated | boolean|null | yes | Whether additional matching records existed beyond the returned result limit. |
No examples provided.
real_estate_fr_market French Real-estate Market ~359
Summarizes local French property transaction prices and yearly trends from geolocated DVF data. Use when: Summarize a French local property market from recorded transactions. Avoid when: Do not use as a listing-price index or a certified appraisal. Limitations: Statistics use up to 200 geolocated DVF single-dwelling mutations per year and residential property type; VEFA/new and professional-use mutations are excluded, with truncation exposed explicitly. DVF does not cover Alsace, Moselle or Mayotte; requests in those areas therefore return an empty result. Price: 0.020 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | – | Optional value for “address” as defined by this API contract. (minimum length 5; maximum length 250). |
| code_insee | string | – | Optional value for “code insee” as defined by this API contract. |
| lookback_years | integer | – | Optional value for “lookback years” as defined by this API contract. (minimum 1; maximum 5; default 5). |
| property_type | string | – | Optional value for “property type” as defined by this API contract. (default all; allowed values: all, house, apartment). |
| radius_m | integer | – | Optional value for “radius m” as defined by this API contract. (minimum 100; maximum 650; default 650). |
| Name | Type | Req | Description |
|---|---|---|---|
| coverage_scope | string | yes | Structured value returned for “coverage scope” as defined by this API contract. (allowed values: radius, commune). |
| generated_at | string | yes | UTC timestamp at which this derived result was generated. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| location | object | yes | Structured value returned for “location” as defined by this API contract. |
| lookback_years | integer | yes | Structured value returned for “lookback years” as defined by this API contract. |
| property_type | string | yes | Structured value returned for “property type” as defined by this API contract. |
| radius_m | integer|null | yes | Structured value returned for “radius m” as defined by this API contract. |
| sample_truncated | boolean|null | yes | Structured value returned for “sample truncated” as defined by this API contract. |
| sampled_count | integer|null | yes | Structured value returned for “sampled count” as defined by this API contract. |
| source_status | string | yes | Availability status of the relevant upstream public source. (allowed values: ok). |
| source_total_count | integer|null | yes | Structured value returned for “source total count” as defined by this API contract. |
| summary | object | yes | Compact derived summary of the returned records. |
| yearly | array | yes | Structured value returned for “yearly” as defined by this API contract. |
No examples provided.
real_estate_fr_parcel French Cadastral Parcel ~257
Identifies French cadastral parcels by address point or cadastral municipality/section/number and returns official IGN geometry. Use when: Identify a French cadastral parcel and retrieve its geometry. Avoid when: Do not treat this as a legally opposable property-title document. Limitations: Address search intersects the geocoded point with cadastral geometry and can return multiple parcels on a parcel boundary. Price: 0.010 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | – | Optional value for “address” as defined by this API contract. (minimum length 5; maximum length 250). |
| code_insee | string | – | Optional value for “code insee” as defined by this API contract. |
| numero | string|integer | – | Optional value for “numero” as defined by this API contract. |
| section | string | – | Optional value for “section” as defined by this API contract. |
| Name | Type | Req | Description |
|---|---|---|---|
| bbox | array|null | yes | Structured value returned for “bbox” as defined by this API contract. |
| generated_at | string | yes | UTC timestamp at which this derived result was generated. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| location | object | yes | Structured value returned for “location” as defined by this API contract. |
| parcels | array | yes | Structured value returned for “parcels” as defined by this API contract. |
| source_status | string | yes | Availability status of the relevant upstream public source. (allowed values: ok). |
| total_count | integer|null | yes | Total number of matching records reported by the source or endpoint. |
No examples provided.
real_estate_fr_risks French Property Risks ~215
Returns the types of natural and technological risks recorded by Géorisques/GASPAR for the municipality of a French property location. Use when: Screen the municipality of a French property location for recorded risk types. Avoid when: Do not interpret municipality-level risk presence as parcel-level exposure. Limitations: This endpoint works at municipality level and is not a regulatory parcel-level risk statement. Price: 0.010 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | – | Optional value for “address” as defined by this API contract. (minimum length 5; maximum length 250). |
| code_insee | string | – | Optional value for “code insee” as defined by this API contract. |
| Name | Type | Req | Description |
|---|---|---|---|
| generated_at | string | yes | UTC timestamp at which this derived result was generated. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| location | object | yes | Structured value returned for “location” as defined by this API contract. |
| risk_count | integer|null | yes | Structured value returned for “risk count” as defined by this API contract. |
| risks | array | yes | Structured value returned for “risks” as defined by this API contract. |
| scope | string | yes | Structured value returned for “scope” as defined by this API contract. (allowed values: commune). |
| source_status | string | yes | Availability status of the relevant upstream public source. (allowed values: ok). |
No examples provided.
real_estate_fr_transactions French Real-estate Transactions ~441
Searches published French geolocated DVF property transactions by address area or municipality, with date, type and amount filters. Use when: Find actual French property sales around an address or in a municipality. Avoid when: Do not use for current property listings or asking prices. Limitations: Geolocated DVF reflects published transactions and can include complex mutations; HelpMyAgent only calculates price per square metre for single-house or single-apartment mutations. DVF does not cover Alsace, Moselle or Mayotte; requests in those areas therefore return an empty result. Price: 0.010 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | – | Optional value for “address” as defined by this API contract. (minimum length 5; maximum length 250). |
| code_insee | string | – | Optional value for “code insee” as defined by this API contract. |
| date_from | string | – | Optional value for “date from” as defined by this API contract. |
| date_to | string | – | Optional value for “date to” as defined by this API contract. |
| limit | integer | – | Maximum number of records returned by this call. (minimum 1; maximum 100; default 20). |
| max_amount | number | – | Optional value for “max amount” as defined by this API contract. (minimum 0). |
| min_amount | number | – | Optional value for “min amount” as defined by this API contract. (minimum 0). |
| property_type | string | – | Optional value for “property type” as defined by this API contract. (default all; allowed values: all, house, apartment). |
| radius_m | integer | – | Optional value for “radius m” as defined by this API contract. (minimum 100; maximum 650; default 500). |
| Name | Type | Req | Description |
|---|---|---|---|
| coverage_scope | string | yes | Structured value returned for “coverage scope” as defined by this API contract. (allowed values: radius, commune). |
| generated_at | string | yes | UTC timestamp at which this derived result was generated. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| location | object | yes | Structured value returned for “location” as defined by this API contract. |
| property_type | string | yes | Structured value returned for “property type” as defined by this API contract. |
| radius_m | integer|null | yes | Structured value returned for “radius m” as defined by this API contract. |
| returned_count | integer|null | yes | Number of records included in this response. |
| source_status | string | yes | Availability status of the relevant upstream public source. (allowed values: ok). |
| source_total_count | integer|null | yes | Structured value returned for “source total count” as defined by this API contract. |
| transactions | array | yes | Structured value returned for “transactions” as defined by this API contract. |
| truncated | boolean|null | yes | Whether additional matching records existed beyond the returned result limit. |
No examples provided.
real_estate_fr_valuation French Property Valuation ~387
Estimates a statistical property value range from nearby or municipal geolocated DVF comparable transactions. Use when: Estimate a French house or apartment from comparable recorded sales. Avoid when: Do not present the result as a certified appraisal or guaranteed sale price. Limitations: Valuation depends on the density of single-dwelling geolocated DVF comparables; VEFA/new and professional-use mutations are excluded, and built area may differ from Carrez area. DVF does not cover Alsace, Moselle or Mayotte; requests in those areas therefore return an empty result. Price: 0.030 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | – | Optional value for “address” as defined by this API contract. (minimum length 5; maximum length 250). |
| code_insee | string | – | Optional value for “code insee” as defined by this API contract. |
| lookback_years | integer | – | Optional value for “lookback years” as defined by this API contract. (minimum 1; maximum 5; default 3). |
| property_type | string | yes | Required value for “property type” as defined by this API contract. (allowed values: house, apartment). |
| radius_m | integer | – | Optional value for “radius m” as defined by this API contract. (minimum 100; maximum 650; default 650). |
| surface_m2 | number | yes | Required value for “surface m2” as defined by this API contract. (minimum 9; maximum 1000). |
| Name | Type | Req | Description |
|---|---|---|---|
| comparable_count | integer|null | yes | Structured value returned for “comparable count” as defined by this API contract. |
| comparables | array | yes | Structured value returned for “comparables” as defined by this API contract. |
| confidence | string | yes | Confidence indicator associated with an inferred or derived result. (allowed values: high, medium, low, insufficient). |
| estimated_range_high | number|integer|null | yes | Structured value returned for “estimated range high” as defined by this API contract. |
| estimated_range_low | number|integer|null | yes | Structured value returned for “estimated range low” as defined by this API contract. |
| estimated_value | number|integer|null | yes | Structured value returned for “estimated value” as defined by this API contract. |
| generated_at | string | yes | UTC timestamp at which this derived result was generated. |
| limitations | array | – | Known interpretation, source-coverage or freshness limitations for this result. |
| location | object | yes | Structured value returned for “location” as defined by this API contract. |
| lookback_years | integer | yes | Structured value returned for “lookback years” as defined by this API contract. |
| median_price_per_m2 | number|integer|null | yes | Structured value returned for “median price per m2” as defined by this API contract. |
| p25_price_per_m2 | number|integer|null | yes | Structured value returned for “p25 price per m2” as defined by this API contract. |
| p75_price_per_m2 | number|integer|null | yes | Structured value returned for “p75 price per m2” as defined by this API contract. |
| property_type | string | yes | Structured value returned for “property type” as defined by this API contract. |
| radius_m | integer|null | yes | Structured value returned for “radius m” as defined by this API contract. |
| source_status | string | yes | Availability status of the relevant upstream public source. (allowed values: ok). |
| source_total_count | integer|null | yes | Structured value returned for “source total count” as defined by this API contract. |
| source_truncated | boolean|null | yes | Structured value returned for “source truncated” as defined by this API contract. |
| surface_m2 | number | yes | Structured value returned for “surface m2” as defined by this API contract. |
No examples provided.
search_apis Search HelpMyAgent APIs ~175
Find published HelpMyAgent capabilities matching a natural-language task or intent without executing or charging for a paid call. Returns matching endpoint descriptors with pricing, coverage, usage guidance and documentation. Optional category, country and max_price filters narrow the catalogue search.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | Optional exact published category slug; when supplied, only APIs in that category are considered. |
| country | string | – | Optional ISO 3166-1 alpha-2 country code, for example FR; matching is case-insensitive and restricts results to APIs declaring that coverage. |
| max_price | number | – | Optional inclusive maximum advertised unit price per call; APIs priced above this value are excluded. |
| query | string | yes | Describe the desired outcome or agent task in natural language; matching uses endpoint names, descriptions, tags, usage guidance and example queries. |
| Name | Type | Req | Description |
|---|---|---|---|
| apis | array | yes | Matching API descriptors including endpoint, pricing, coverage, usage guidance and documentation links. |
| count | integer | yes | Number of published APIs matching the supplied discovery criteria. |
No examples provided.
vat_eu_validate EU VAT Validation ~303
Validates an EU VAT number through the European Commission VIES service, with explicit unavailable status. Use when: Validate an EU VAT number before invoicing or supplier onboarding. You need to validate an EU VAT number through the European Commission VIES service before invoicing or onboarding. You have either a complete VAT number or a country code plus national number. Avoid when: You need invoice-level consistency for a French company identifier; use company/fr/invoice-check. You need broader supplier identity, compliance or IBAN checks; use company/fr/supplier-verification. Limitations: Validation depends on VIES availability and on the member-state data returned through that service. A valid VAT number does not prove bank-account ownership, solvency or absence of fraud. Price: 0.005 USD per call via x402. Paid-call behavior: source records are not modified, but a successful invocation can consume the advertised x402 payment; the payment-required challenge is free, and repeating the tool after a completed paid invocation may require a new payment. Accepted x402 networks: eip155:8453, xrpl:0.
| Name | Type | Req | Description |
|---|---|---|---|
| country_code | string | – | EU/VIES country prefix used when the VAT number is supplied in separate parts. |
| number | string | – | National VAT identifier body without the country prefix, used together with country_code. |
| vat_number | string | – | Complete EU VAT number including the two-letter country prefix; alternatively provide country_code and number separately. |
| Name | Type | Req | Description |
|---|---|---|---|
| address | string|null | yes | Structured value returned for “address” as defined by this API contract. |
| checked_at | string | yes | UTC timestamp at which HelpMyAgent performed the check. |
| country_code | string | yes | Structured value returned for “country code” as defined by this API contract. |
| name | string|null | yes | Publicly available company, person, buyer or record name for this result. |
| number | string | yes | Structured value returned for “number” as defined by this API contract. |
| request_date | string|null | yes | Structured value returned for “request date” as defined by this API contract. |
| request_identifier | string|null | yes | Structured value returned for “request identifier” as defined by this API contract. |
| source | string | yes | Structured value returned for “source” as defined by this API contract. |
| status | string | yes | Normalized endpoint or source status. |
| valid | boolean|null | yes | Whether the supplied identifier passed the endpoint’s validation rules. |
| vat_number | string | yes | Structured value returned for “vat number” as defined by this API contract. |
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.