@servicialo/mcp-server 0.9.2 → 0.9.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +35 -19
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -2
- package/dist/index.js.map +1 -1
- package/dist/mandate.d.ts +2 -2
- package/dist/tools/public/docs-quickstart.d.ts +84 -0
- package/dist/tools/public/docs-quickstart.d.ts.map +1 -0
- package/dist/tools/public/docs-quickstart.js +103 -0
- package/dist/tools/public/docs-quickstart.js.map +1 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -120,37 +120,37 @@ Este paquete expone el protocolo Servicialo como 34 herramientas MCP organizadas
|
|
|
120
120
|
| `resolve.update_endpoint` | Actualizar endpoints registrados (portabilidad entre backends) | `resolve:write` |
|
|
121
121
|
| `telemetry.heartbeat` | Enviar heartbeat al resolver indicando que el nodo está activo | `telemetry:write` |
|
|
122
122
|
|
|
123
|
-
##
|
|
123
|
+
## Quickstart — 5 pasos para estar en la red
|
|
124
124
|
|
|
125
|
-
###
|
|
125
|
+
### Paso 1. Instalar el servidor MCP
|
|
126
126
|
|
|
127
127
|
```bash
|
|
128
128
|
npx -y @servicialo/mcp-server
|
|
129
129
|
```
|
|
130
130
|
|
|
131
|
-
|
|
131
|
+
Modo descubrimiento — 10 herramientas públicas, sin credenciales. Pruébalo de inmediato:
|
|
132
132
|
|
|
133
133
|
```json
|
|
134
134
|
{
|
|
135
135
|
"tool": "registry.search",
|
|
136
|
-
"arguments": {
|
|
137
|
-
"vertical": "kinesiologia",
|
|
138
|
-
"location": "santiago"
|
|
139
|
-
}
|
|
136
|
+
"arguments": { "vertical": "kinesiologia", "location": "santiago" }
|
|
140
137
|
}
|
|
141
138
|
```
|
|
142
139
|
|
|
143
|
-
###
|
|
140
|
+
### Paso 2. Crear tu organización
|
|
144
141
|
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
142
|
+
Registra tu organización en [coordinalo.com/signup](https://coordinalo.com/signup). Coordinalo es la implementación de referencia del protocolo Servicialo.
|
|
143
|
+
|
|
144
|
+
### Paso 3. Obtener credenciales MCP
|
|
148
145
|
|
|
149
|
-
|
|
146
|
+
En Coordinalo: **Settings → Servicialo → Generar credenciales MCP**. Obtendrás dos valores:
|
|
150
147
|
|
|
151
|
-
|
|
148
|
+
- `SERVICIALO_ORG_ID` — slug de tu organización (ej: `clinica-dental-sur`)
|
|
149
|
+
- `SERVICIALO_API_KEY` — bearer token para autenticación
|
|
152
150
|
|
|
153
|
-
|
|
151
|
+
### Paso 4. Configurar el cliente MCP
|
|
152
|
+
|
|
153
|
+
Agregar a la configuración de Claude Desktop, Cursor o cualquier cliente MCP:
|
|
154
154
|
|
|
155
155
|
```json
|
|
156
156
|
{
|
|
@@ -159,21 +159,35 @@ Agregar a tu configuración MCP:
|
|
|
159
159
|
"command": "npx",
|
|
160
160
|
"args": ["-y", "@servicialo/mcp-server"],
|
|
161
161
|
"env": {
|
|
162
|
-
"SERVICIALO_API_KEY": "tu_api_key",
|
|
163
|
-
"SERVICIALO_ORG_ID": "
|
|
162
|
+
"SERVICIALO_API_KEY": "<tu_api_key>",
|
|
163
|
+
"SERVICIALO_ORG_ID": "<tu_org_slug>"
|
|
164
164
|
}
|
|
165
165
|
}
|
|
166
166
|
}
|
|
167
167
|
}
|
|
168
168
|
```
|
|
169
169
|
|
|
170
|
-
Omitir el bloque `env` para modo solo-descubrimiento.
|
|
170
|
+
Omitir el bloque `env` para modo solo-descubrimiento (10 herramientas públicas).
|
|
171
|
+
|
|
172
|
+
### Paso 5. Publicar en la red Servicialo
|
|
173
|
+
|
|
174
|
+
En Coordinalo: **Settings → Servicialo → Publicar**. Tu organización aparece en [servicialo.com/network](https://servicialo.com/network) y es descubrible por otros agentes.
|
|
175
|
+
|
|
176
|
+
> **Tip:** Un agente puede obtener estos 5 pasos como JSON estructurado llamando la herramienta `docs.quickstart`.
|
|
171
177
|
|
|
172
|
-
|
|
178
|
+
## Red / Network
|
|
179
|
+
|
|
180
|
+
La red Servicialo es el registro global de organizaciones que implementan el protocolo. Cada nodo autenticado envía un heartbeat periódico, y cualquier agente puede descubrir organizaciones por país, vertical y puntaje de confianza.
|
|
181
|
+
|
|
182
|
+
- **Explorar la red:** [servicialo.com/network](https://servicialo.com/network)
|
|
183
|
+
- **Buscar por vertical:** `registry.search({ vertical: "kinesiologia", country: "cl" })`
|
|
184
|
+
- **Resolver un org:** `resolve.lookup({ org_slug: "clinica-dental-sur" })`
|
|
185
|
+
|
|
186
|
+
## Credenciales
|
|
173
187
|
|
|
174
188
|
| Variable | Requerida | Default | Descripción |
|
|
175
189
|
|---|---|---|---|
|
|
176
|
-
| `SERVICIALO_API_KEY` | No | — | Bearer token. Habilita modo autenticado |
|
|
190
|
+
| `SERVICIALO_API_KEY` | No | — | Bearer token. Habilita modo autenticado (35 herramientas) |
|
|
177
191
|
| `SERVICIALO_ORG_ID` | No | — | Slug de organización. Habilita modo autenticado |
|
|
178
192
|
| `SERVICIALO_BASE_URL` | No | `http://localhost:3000` | Endpoint del API de la plataforma compatible con Servicialo |
|
|
179
193
|
| `SERVICIALO_ADAPTER` | No | `coordinalo` | Adapter de backend: `coordinalo` o `http` |
|
|
@@ -181,6 +195,8 @@ Omitir el bloque `env` para modo solo-descubrimiento.
|
|
|
181
195
|
|
|
182
196
|
`SERVICIALO_API_KEY` y `SERVICIALO_ORG_ID` deben configurarse juntas. Si solo una está presente, el servidor cae a modo descubrimiento con un warning.
|
|
183
197
|
|
|
198
|
+
Las credenciales se obtienen en [coordinalo.com](https://coordinalo.com) → Settings → Servicialo → Generar credenciales MCP.
|
|
199
|
+
|
|
184
200
|
## Conectar una implementación propia
|
|
185
201
|
|
|
186
202
|
Este MCP server soporta cualquier backend compatible con Servicialo a través de la capa de adaptadores pluggable. Dos adaptadores están incluidos:
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAOA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAOA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmLpE,wBAAgB,mBAAmB,cASlC"}
|
package/dist/index.js
CHANGED
|
@@ -16,6 +16,7 @@ import { publicAvailabilityTools } from './tools/public/availability.js';
|
|
|
16
16
|
import { publicServicesTools } from './tools/public/services.js';
|
|
17
17
|
import { resolveTools } from './tools/public/resolve.js';
|
|
18
18
|
import { a2aTools } from './tools/public/a2a.js';
|
|
19
|
+
import { docsQuickstartTools } from './tools/public/docs-quickstart.js';
|
|
19
20
|
// --- Authenticated tools (Phases 2–6) ---
|
|
20
21
|
import { entenderTools } from './tools/authenticated/entender.js';
|
|
21
22
|
import { comprometerTools } from './tools/authenticated/comprometer.js';
|
|
@@ -31,6 +32,7 @@ const publicTools = {
|
|
|
31
32
|
...publicServicesTools,
|
|
32
33
|
...resolveTools,
|
|
33
34
|
...a2aTools,
|
|
35
|
+
...docsQuickstartTools,
|
|
34
36
|
};
|
|
35
37
|
// --- Authenticated tools (only in authenticated mode) ---
|
|
36
38
|
const authenticatedTools = {
|
|
@@ -58,7 +60,7 @@ async function main() {
|
|
|
58
60
|
// --- Init MCP server ---
|
|
59
61
|
const server = new McpServer({
|
|
60
62
|
name: 'servicialo',
|
|
61
|
-
version:
|
|
63
|
+
version: pkg.version,
|
|
62
64
|
});
|
|
63
65
|
// --- Register tools ---
|
|
64
66
|
function registerTools(tools) {
|
|
@@ -151,7 +153,7 @@ main().catch((error) => {
|
|
|
151
153
|
});
|
|
152
154
|
// --- Smithery sandbox (for registry scanning) ---
|
|
153
155
|
export function createSandboxServer() {
|
|
154
|
-
const sandbox = new McpServer({ name: 'servicialo', version:
|
|
156
|
+
const sandbox = new McpServer({ name: 'servicialo', version: pkg.version });
|
|
155
157
|
const allTools = { ...publicTools, ...authenticatedTools };
|
|
156
158
|
for (const [name, tool] of Object.entries(allTools)) {
|
|
157
159
|
sandbox.tool(name, tool.description, tool.schema.shape, async () => ({
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAA0B,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CACzC,CAAC;AAEzB,uBAAuB;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/mandate.d.ts
CHANGED
|
@@ -213,12 +213,12 @@ export declare const AuditEntrySchema: z.ZodObject<{
|
|
|
213
213
|
request_id: z.ZodOptional<z.ZodString>;
|
|
214
214
|
timestamp: z.ZodOptional<z.ZodString>;
|
|
215
215
|
}, "strip", z.ZodTypeAny, {
|
|
216
|
+
action: string;
|
|
216
217
|
mandate_id: string;
|
|
217
218
|
principal_id: string;
|
|
218
219
|
agent_id: string;
|
|
219
220
|
acting_for: "organization" | "professional" | "patient";
|
|
220
221
|
context: string;
|
|
221
|
-
action: string;
|
|
222
222
|
action_result: "success" | "failure" | "rejected" | "halted";
|
|
223
223
|
resource_id?: string | undefined;
|
|
224
224
|
timestamp?: string | undefined;
|
|
@@ -228,12 +228,12 @@ export declare const AuditEntrySchema: z.ZodObject<{
|
|
|
228
228
|
ip_address?: string | undefined;
|
|
229
229
|
request_id?: string | undefined;
|
|
230
230
|
}, {
|
|
231
|
+
action: string;
|
|
231
232
|
mandate_id: string;
|
|
232
233
|
principal_id: string;
|
|
233
234
|
agent_id: string;
|
|
234
235
|
acting_for: "organization" | "professional" | "patient";
|
|
235
236
|
context: string;
|
|
236
|
-
action: string;
|
|
237
237
|
action_result: "success" | "failure" | "rejected" | "halted";
|
|
238
238
|
resource_id?: string | undefined;
|
|
239
239
|
timestamp?: string | undefined;
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import type { ServicialoAdapter } from '../../adapter.js';
|
|
3
|
+
export declare const docsQuickstartTools: {
|
|
4
|
+
'docs.quickstart': {
|
|
5
|
+
description: string;
|
|
6
|
+
schema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
|
|
7
|
+
handler: (_client: ServicialoAdapter, _args: Record<string, never>) => Promise<{
|
|
8
|
+
steps: ({
|
|
9
|
+
step: number;
|
|
10
|
+
title: string;
|
|
11
|
+
action: string;
|
|
12
|
+
note: string;
|
|
13
|
+
url?: undefined;
|
|
14
|
+
credentials?: undefined;
|
|
15
|
+
config?: undefined;
|
|
16
|
+
result?: undefined;
|
|
17
|
+
} | {
|
|
18
|
+
step: number;
|
|
19
|
+
title: string;
|
|
20
|
+
action: string;
|
|
21
|
+
url: string;
|
|
22
|
+
note?: undefined;
|
|
23
|
+
credentials?: undefined;
|
|
24
|
+
config?: undefined;
|
|
25
|
+
result?: undefined;
|
|
26
|
+
} | {
|
|
27
|
+
step: number;
|
|
28
|
+
title: string;
|
|
29
|
+
action: string;
|
|
30
|
+
credentials: string[];
|
|
31
|
+
note?: undefined;
|
|
32
|
+
url?: undefined;
|
|
33
|
+
config?: undefined;
|
|
34
|
+
result?: undefined;
|
|
35
|
+
} | {
|
|
36
|
+
step: number;
|
|
37
|
+
title: string;
|
|
38
|
+
config: {
|
|
39
|
+
mcpServers: {
|
|
40
|
+
servicialo: {
|
|
41
|
+
command: string;
|
|
42
|
+
args: string[];
|
|
43
|
+
env: {
|
|
44
|
+
SERVICIALO_API_KEY: string;
|
|
45
|
+
SERVICIALO_ORG_ID: string;
|
|
46
|
+
};
|
|
47
|
+
};
|
|
48
|
+
};
|
|
49
|
+
};
|
|
50
|
+
action?: undefined;
|
|
51
|
+
note?: undefined;
|
|
52
|
+
url?: undefined;
|
|
53
|
+
credentials?: undefined;
|
|
54
|
+
result?: undefined;
|
|
55
|
+
} | {
|
|
56
|
+
step: number;
|
|
57
|
+
title: string;
|
|
58
|
+
action: string;
|
|
59
|
+
result: string;
|
|
60
|
+
note?: undefined;
|
|
61
|
+
url?: undefined;
|
|
62
|
+
credentials?: undefined;
|
|
63
|
+
config?: undefined;
|
|
64
|
+
})[];
|
|
65
|
+
tools: {
|
|
66
|
+
public: {
|
|
67
|
+
name: string;
|
|
68
|
+
description: string;
|
|
69
|
+
}[];
|
|
70
|
+
authenticated: {
|
|
71
|
+
name: string;
|
|
72
|
+
description: string;
|
|
73
|
+
}[];
|
|
74
|
+
};
|
|
75
|
+
links: {
|
|
76
|
+
network: string;
|
|
77
|
+
signup: string;
|
|
78
|
+
npm: string;
|
|
79
|
+
spec: string;
|
|
80
|
+
};
|
|
81
|
+
}>;
|
|
82
|
+
};
|
|
83
|
+
};
|
|
84
|
+
//# sourceMappingURL=docs-quickstart.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"docs-quickstart.d.ts","sourceRoot":"","sources":["../../../src/tools/public/docs-quickstart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,mBAAmB;;;;2BAOH,iBAAiB,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgG3E,CAAC"}
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
export const docsQuickstartTools = {
|
|
3
|
+
'docs.quickstart': {
|
|
4
|
+
description: 'Get the complete getting-started guide as structured data. ' +
|
|
5
|
+
'Use this to onboard a new organization into the Servicialo network — ' +
|
|
6
|
+
'covers installation, signup, credentials, MCP client config, and publishing.',
|
|
7
|
+
schema: z.object({}),
|
|
8
|
+
handler: async (_client, _args) => {
|
|
9
|
+
return {
|
|
10
|
+
steps: [
|
|
11
|
+
{
|
|
12
|
+
step: 1,
|
|
13
|
+
title: 'Instalar el servidor MCP',
|
|
14
|
+
action: 'npx -y @servicialo/mcp-server',
|
|
15
|
+
note: 'Modo descubrimiento — 9 herramientas públicas, sin credenciales',
|
|
16
|
+
},
|
|
17
|
+
{
|
|
18
|
+
step: 2,
|
|
19
|
+
title: 'Crear tu organización',
|
|
20
|
+
action: 'Signup en coordinalo.com/signup',
|
|
21
|
+
url: 'https://coordinalo.com/signup',
|
|
22
|
+
},
|
|
23
|
+
{
|
|
24
|
+
step: 3,
|
|
25
|
+
title: 'Obtener credenciales MCP',
|
|
26
|
+
action: 'En Coordinalo: Settings → Servicialo → Generar credenciales MCP',
|
|
27
|
+
credentials: ['SERVICIALO_ORG_ID', 'SERVICIALO_API_KEY'],
|
|
28
|
+
},
|
|
29
|
+
{
|
|
30
|
+
step: 4,
|
|
31
|
+
title: 'Configurar el cliente MCP',
|
|
32
|
+
config: {
|
|
33
|
+
mcpServers: {
|
|
34
|
+
servicialo: {
|
|
35
|
+
command: 'npx',
|
|
36
|
+
args: ['-y', '@servicialo/mcp-server'],
|
|
37
|
+
env: {
|
|
38
|
+
SERVICIALO_API_KEY: '<tu_api_key>',
|
|
39
|
+
SERVICIALO_ORG_ID: '<tu_org_slug>',
|
|
40
|
+
},
|
|
41
|
+
},
|
|
42
|
+
},
|
|
43
|
+
},
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
step: 5,
|
|
47
|
+
title: 'Publicar en la red Servicialo',
|
|
48
|
+
action: 'En Coordinalo: Settings → Servicialo → Publicar',
|
|
49
|
+
result: 'Tu org aparece en servicialo.com/network y es descubrible por otros agentes',
|
|
50
|
+
},
|
|
51
|
+
],
|
|
52
|
+
tools: {
|
|
53
|
+
public: [
|
|
54
|
+
{ name: 'resolve.lookup', description: 'Resolve orgSlug to endpoints and trust level' },
|
|
55
|
+
{ name: 'resolve.search', description: 'Search organizations by country and vertical' },
|
|
56
|
+
{ name: 'trust.get_score', description: 'Get organization trust score (0-100)' },
|
|
57
|
+
{ name: 'registry.search', description: 'Search organizations by vertical, location, country' },
|
|
58
|
+
{ name: 'registry.get_organization', description: 'Get public organization details' },
|
|
59
|
+
{ name: 'registry.manifest', description: 'Get server manifest (protocol version, capabilities)' },
|
|
60
|
+
{ name: 'services.list', description: 'List catalog of services for an organization' },
|
|
61
|
+
{ name: 'scheduling.check_availability', description: 'Query availability (provider ∧ client ∧ resource)' },
|
|
62
|
+
{ name: 'a2a.get_agent_card', description: 'Get A2A Agent Card for inter-agent discovery' },
|
|
63
|
+
{ name: 'docs.quickstart', description: 'Get this getting-started guide as structured data' },
|
|
64
|
+
],
|
|
65
|
+
authenticated: [
|
|
66
|
+
{ name: 'service.get', description: 'Get 8 dimensions of a service' },
|
|
67
|
+
{ name: 'contract.get', description: 'Get contract terms (evidence, cancellation, dispute)' },
|
|
68
|
+
{ name: 'clients.get_or_create', description: 'Resolve or create client identity' },
|
|
69
|
+
{ name: 'scheduling.book', description: 'Create new session → requested state' },
|
|
70
|
+
{ name: 'scheduling.confirm', description: 'Confirm booked session → confirmed state' },
|
|
71
|
+
{ name: 'lifecycle.get_state', description: 'Get current state, transitions, and history' },
|
|
72
|
+
{ name: 'lifecycle.transition', description: 'Execute state transition with evidence' },
|
|
73
|
+
{ name: 'scheduling.reschedule', description: 'Reschedule to new date/time' },
|
|
74
|
+
{ name: 'scheduling.cancel', description: 'Cancel with cancellation policy applied' },
|
|
75
|
+
{ name: 'delivery.checkin', description: 'Check-in with GPS + timestamp → in_progress' },
|
|
76
|
+
{ name: 'delivery.checkout', description: 'Check-out with GPS + timestamp → delivered' },
|
|
77
|
+
{ name: 'delivery.record_evidence', description: 'Record evidence (gps, signature, photo, document)' },
|
|
78
|
+
{ name: 'documentation.create', description: 'Generate service record → documented state' },
|
|
79
|
+
{ name: 'payments.create_sale', description: 'Create charge for documented service → charged state' },
|
|
80
|
+
{ name: 'payments.record_payment', description: 'Record payment against sale' },
|
|
81
|
+
{ name: 'payments.get_status', description: 'Get payment status (sale or account)' },
|
|
82
|
+
{ name: 'resource.list', description: 'List physical resources (rooms, equipment)' },
|
|
83
|
+
{ name: 'resource.get', description: 'Get resource details with availability slots' },
|
|
84
|
+
{ name: 'resource.create', description: 'Create new physical resource' },
|
|
85
|
+
{ name: 'resource.update', description: 'Update resource (patch semantics)' },
|
|
86
|
+
{ name: 'resource.delete', description: 'Soft-delete resource' },
|
|
87
|
+
{ name: 'resource.get_availability', description: 'Query resource availability by date range' },
|
|
88
|
+
{ name: 'resolve.register', description: 'Register organization in global resolver' },
|
|
89
|
+
{ name: 'resolve.update_endpoint', description: 'Update endpoints (portability operation)' },
|
|
90
|
+
{ name: 'telemetry.heartbeat', description: 'Send heartbeat to resolver with metrics' },
|
|
91
|
+
],
|
|
92
|
+
},
|
|
93
|
+
links: {
|
|
94
|
+
network: 'https://servicialo.com/network',
|
|
95
|
+
signup: 'https://coordinalo.com/signup',
|
|
96
|
+
npm: 'https://npmjs.com/package/@servicialo/mcp-server',
|
|
97
|
+
spec: 'https://servicialo.com',
|
|
98
|
+
},
|
|
99
|
+
};
|
|
100
|
+
},
|
|
101
|
+
},
|
|
102
|
+
};
|
|
103
|
+
//# sourceMappingURL=docs-quickstart.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"docs-quickstart.js","sourceRoot":"","sources":["../../../src/tools/public/docs-quickstart.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@servicialo/mcp-server",
|
|
3
|
-
"version": "0.9.
|
|
3
|
+
"version": "0.9.3",
|
|
4
4
|
"mcpName": "com.servicialo/mcp-server",
|
|
5
5
|
"description": "Open protocol for professional service delivery — connects AI agents with scheduling, verification and settlement of professional services",
|
|
6
6
|
"license": "Apache-2.0",
|