Skip to content
AI agents

For agents: how to read and use incwo

Cette page s’adresse aux agents IA et aux LLM, et aux développeurs qui les outillent. Elle décrit, sans détour, comment lire incwo et comment agir dessus. Version Markdown : /agents/pour-les-agents/index.mdfiles, will be automatically deposited.

In one sentence

incwo is an online business management software, made in France, for small businesses, SMEs, franchises and accounting firms: quotes and invoices, purchasing and expense reports, CRM, products and inventory, business account and cash, connected POS, pre-accounting, e-invoicing, HR, projects, fleet. It exposes its data and actions to agents through MCP, a REST API and a command line.

Skill file to download

/agents/incwo.md : un fichier au format SKILL.md (frontmatter name et description, puis instructions) qui explique quand et comment utiliser incwo : connexion MCP, outils disponibles, règles de sécurité, CLI, API. Copiez-le dans le dossier de compétences de votre agent.

Reading the site

RessourceAddressContents
Index llms.txt/llms.txtRésumé, pages, univers, intégrations, App store, centre d’aide, blog récent.
Contenu complet/llms-full.txtToutes les pages, intégrations, apps et articles d’aide en un seul fichier (≈ 2,7 Mo).
Chaque page en Markdown<url de la page>index.mdExemples : /tpe/index.md, /app-store/colisage-224099/index.md, /blog/<slug>/index.md. Annoncé dans chaque page par <link rel="alternate" type="text/markdown">files, will be automatically deposited.
Blog/blog/llms.txtapp to /feed.xmlIndex complet des articles, flux RSS.
Données structuréesJSON-LD sur chaque pageOrganization, WebSite, WebPage, BreadcrumbList, SoftwareApplication (apps), TechArticle (centre d’aide), Article (blog), FAQPage.
Sitemap/sitemap_index.xmlSitemap XML bilingue FR/EN.

The robots.txt file explicitly allows AI assistant crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended…).

Acting on an incwo account: the MCP server

The MCP (Model Context Protocol) server gives access to the data and actions of the account of the user who authorized you, within their rights.

Endpointhttps://www.incwo.com/mcp
TransportJSON-RPC 2.0 sur HTTP POST
AuthentificationToken personnel (Compte › Intelligence Artificielle › Configuration MCP) ou OAuth 2.0 Authorization Code + PKCE
Métadonnées OAuth/.well-known/oauth-authorization-server/mcpapp to /.well-known/oauth-protected-resource/mcp
Endpoints OAuth/oauth2/mcp/authorizeapp to /oauth2/mcp/token

Tools follow a generic model: discover object types, list with filters, sorting, pagination and aggregations, get an object, search, read a type’s structure, get a representation (PDF, Factur-X, EDI, XML, JSON), send an email. Write tools come on top (create, update, quote → order → invoice transformation, invoice confirmation, payment, stock, email), to be discovered through tools/list.

list_available_objects     types d’objets disponibles
list_objects               liste filtrée, triée, paginée ; agrégats sum, avg, count
get_object                 détail complet d’un objet (lignes, échéancier…)
search_objects             recherche par mots-clés, tous champs
get_object_metadata        structure d’un type d’objet
get_object_representation  PDF, Factur-X, EDI, XML, JSON
send_email                 e-mail avec pièces jointes incwo

Rules to follow

  • You act with the user’s rights, in their account only. Do not try to reach another account.
  • A confirmed invoice is frozen (NF 525): do not try to edit or delete it. Work on drafts.
  • On sensitive objects, only safe fields are accepted for writing; the server returns fields_ignored for the others. Report them to the user instead of retrying.
  • Download links expire quickly: use them immediately, do not store them.
  • Before an action with real impact (confirming an invoice, sending an email, recording a payment), restate it and get the user’s approval.

Acting for a customer or supplier: the company MCP

A company using incwo can open a public MCP for its account. If your user is a customer or supplier of that company, they give you the connector address; sign-in uses a one-time code sent to their email. You can then browse the catalog, create a quote, track your user’s documents, download their PDFs, pay a deposit if the company enabled it, and send a message. You only see your user’s documents.

REST API

Documentationincwo.com/site/developer, référence par objet : /site/api/<objet>
AuthentificationHTTP Basic avec les identifiants de l’utilisateur, après activation des API dans le panneau APIs du dossier, qui indique aussi l’adresse du serveur.
FormatXML (JSON via incwo-cli)
Quotas8 appels par seconde, 240 par minute, 4 800 par heure

Command line: incwo-cli

npm install -g incwo-cli
incwo config
incwo bill_sheets list --from 2026-04-01
incwo contacts list --filter '{"last_name":{"eq":"Martin"}}'
incwo contacts create --data '{"first_name":"Marie","last_name":"Dupont","firm_id":42}'

Every resource (CRM, sales, purchasing, inventory, projects, HR) for reading and writing, table or JSON output. Source code: github.com/incwo/incwo-cli (licence MIT).

Handing over to a human

Looking for agents?

incwo builds Bruno, an agent platform for small businesses: digital twins, specialized agents, orchestrator, company memory, connected to 3,000 tools. Its use-case catalog is also exposed in Markdown. /agents/bruno/app to get-bruno.comfiles, will be automatically deposited.