DocsFor agents
Files for AI agents
An agent learns Conecto from files, with no person in between. These are the files, where they live and what each one holds.
| File | Address | What it holds |
|---|---|---|
| SKILL.md | https://conecto.chat/SKILL.md | How to sign up, call, pay and keep the business safe, then every area with its prices and tools. |
| About Conecto | https://conecto.chat/ai-questions.md | What Conecto is, who founded it, what it costs and its key facts. The same facts as JSON at https://conecto.chat/ai-questions.json. |
| The docs | https://conecto.chat/docs/all.md | Every page of these docs in one Markdown file. |
| The docs' index | https://conecto.chat/docs/index.json | Each page's title, description, address and Markdown address. |
| The tools | https://conecto.chat/tools.md | Every area with its tools and prices, in Markdown. |
| The REST API | https://api.conecto.chat/v1/openapi.json | OpenAPI 3.1 with every route and every tool. |
https://conecto.chat/SKILL.md is the file an agent keeps in every session, and https://api.conecto.chat/v1/skill.md answers the same. Its sections:
- Start: one call
- Then connect over MCP, once
- Calling tools
- The business's own systems
- Running the account
- Money
- Rules that keep the business safe
- Areas and tools
Agents that look for skills on their own find it in the skills index at https://conecto.chat/.well-known/agent-skills/index.json, in the draft Agent Skills discovery format:
{
"$schema": "https://schemas.agentskills.io/discovery/0.2.0/schema.json",
"skills": [
{
"name": "conecto",
"type": "skill-md",
"description": "Use Conecto when a business needs a backend you can run yourself: CRM, email inboxes, phone numbers answered by an AI assistant, website chat, help desk and help center, AI visibility and more. One API call signs up with $1.00 free credit; every tool call is paid from a prepaid balance, and failed calls cost nothing.",
"url": "/.well-known/agent-skills/conecto/SKILL.md",
"digest": "sha256:34e940f023c9664df1f66a934abb6db9437f903263de49e1ae26fa36c19a0671"
}
]
}The digest is the SHA-256 of the file's bytes, so an agent can check the copy it fetched. The older index at https://conecto.chat/.well-known/skills/index.json lists the same file for Hermes Agent.
These answer without a key.
| Address | What it answers |
|---|---|
GET https://api.conecto.chat/ |
What Conecto is, how to sign up, the prices in a few words and every area's MCP address. |
GET https://api.conecto.chat/ |
Every area with its summary and its number of tools. |
GET https://api.conecto.chat/ |
Every tool with its price, or one area's with ?area=crm. |
GET https://api.conecto.chat/ |
One tool with its input schema and examples. |
https://conecto.chat/ |
One tool's page: its inputs, an example call, a real reply and its errors. |
The REST API shows each reply.
| File | Address |
|---|---|
| Every route and tool, OpenAPI 3.1 | https://api.conecto.chat/ |
| One area, OpenAPI 3.0, for tools that import it (custom GPTs until OpenAI retires them on December 11, 2026) | https://api.conecto.chat/ |
| One area, OpenAPI 2.0, for Power Platform | https://api.conecto.chat/ |
Every page of these docs names the full file in a <link rel="service-desc"> in its head.
https://api.conecto.chat/ serves every area a key may use, whether an agent sends its key or an assistant signs in, and https://api.conecto.chat/ one area at a time, for an agent with a key. Connect your agent lists the addresses. A server answers initialize like this:
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"protocolVersion": "2025-11-25",
"capabilities": {
"tools": {
"listChanged": false
}
},
"serverInfo": {
"name": "conecto-crm",
"version": "1.0.0",
"title": "Conecto CRM"
},
"instructions": "Conecto CRM: Contacts, companies and deals in pipelines, with notes, tasks, tags, custom fields, saved segments, one search, full timelines, duplicate merging, bulk saves, reports and CSV export: the business's customer records. Every tool lists its price; reads are free up to 1,000,000 a month for the account (then $0.50 per 10,000), and a call that fails is never charged. Pay from your Conecto balance (GET https://api.conecto.chat/v1/balance)."
}
}A connector's sign-in follows OAuth 2.1. The authorization server's metadata:
{
"issuer": "https://conecto.chat/api/bots/oauth",
"authorization_endpoint": "https://conecto.chat/api/bots/oauth/authorize",
"token_endpoint": "https://conecto.chat/api/bots/oauth/token",
"registration_endpoint": "https://conecto.chat/api/bots/oauth/register",
"revocation_endpoint": "https://conecto.chat/api/bots/oauth/revoke",
"response_types_supported": ["code"],
"grant_types_supported": [
"authorization_code",
"refresh_token",
"urn:ietf:params:oauth:grant-type:jwt-bearer"
],
"token_endpoint_auth_methods_supported": ["none"],
"revocation_endpoint_auth_methods_supported": ["none"],
"code_challenge_methods_supported": ["S256"],
"scopes_supported": ["tools", "offline_access"],
"authorization_response_iss_parameter_supported": true,
"service_documentation": "https://conecto.chat/tools"
}The connector's protected-resource metadata:
{
"resource": "https://api.conecto.chat/v1/mcp",
"authorization_servers": ["https://conecto.chat/api/bots/oauth"],
"scopes_supported": ["tools"],
"bearer_methods_supported": ["header"],
"resource_name": "Conecto",
"resource_documentation": "https://conecto.chat/docs/connect"
}- Every page has a Markdown twin at its address plus
.md, like https://conecto.chat/docs/keys.md, and its links are full addresses. - A request for a page with
Accept: text/markdowngets the twin at the page's own address. - https://conecto.chat/docs/all.md holds every page in one file, in the order of the navigation.
- https://conecto.chat/docs/index.json lists every page with its title, description, address and Markdown address.
curl -H "Accept: text/markdown" https://conecto.chat/docs/quickstartEach page also has buttons that copy its Markdown or open it in ChatGPT or Claude. The site's https://conecto.chat/llms.txt lists its main pages for language models.
Updated . Every route, field and number here is read from the API's own code.