@yolk-sdk/emulators 0.1.0-canary.100
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/LICENSE +21 -0
- package/README.md +2165 -0
- package/dist/anthropic.d.mts +269 -0
- package/dist/anthropic.d.mts.map +1 -0
- package/dist/anthropic.mjs +177 -0
- package/dist/anthropic.mjs.map +1 -0
- package/dist/chat-completions.d.mts +288 -0
- package/dist/chat-completions.d.mts.map +1 -0
- package/dist/chat-completions.mjs +451 -0
- package/dist/chat-completions.mjs.map +1 -0
- package/dist/codex.d.mts +265 -0
- package/dist/codex.d.mts.map +1 -0
- package/dist/codex.mjs +199 -0
- package/dist/codex.mjs.map +1 -0
- package/dist/dropbox/api.d.mts +63 -0
- package/dist/dropbox/api.d.mts.map +1 -0
- package/dist/dropbox/api.mjs +565 -0
- package/dist/dropbox/api.mjs.map +1 -0
- package/dist/dropbox/state.d.mts +136 -0
- package/dist/dropbox/state.d.mts.map +1 -0
- package/dist/dropbox/state.mjs +209 -0
- package/dist/dropbox/state.mjs.map +1 -0
- package/dist/dropbox.d.mts +79 -0
- package/dist/dropbox.d.mts.map +1 -0
- package/dist/dropbox.mjs +124 -0
- package/dist/dropbox.mjs.map +1 -0
- package/dist/email-fixtures.d.mts +36 -0
- package/dist/email-fixtures.d.mts.map +1 -0
- package/dist/email-fixtures.mjs +1080 -0
- package/dist/email-fixtures.mjs.map +1 -0
- package/dist/email.d.mts +160 -0
- package/dist/email.d.mts.map +1 -0
- package/dist/email.mjs +608 -0
- package/dist/email.mjs.map +1 -0
- package/dist/emulator-compose.d.mts +40 -0
- package/dist/emulator-compose.d.mts.map +1 -0
- package/dist/emulator-compose.mjs +91 -0
- package/dist/emulator-compose.mjs.map +1 -0
- package/dist/emulator-http.d.mts +53 -0
- package/dist/emulator-http.d.mts.map +1 -0
- package/dist/emulator-http.mjs +117 -0
- package/dist/emulator-http.mjs.map +1 -0
- package/dist/emulator-kernel.d.mts +176 -0
- package/dist/emulator-kernel.d.mts.map +1 -0
- package/dist/emulator-kernel.mjs +413 -0
- package/dist/emulator-kernel.mjs.map +1 -0
- package/dist/fixture-route.d.mts +129 -0
- package/dist/fixture-route.d.mts.map +1 -0
- package/dist/fixture-route.mjs +257 -0
- package/dist/fixture-route.mjs.map +1 -0
- package/dist/fortnox/api.d.mts +92 -0
- package/dist/fortnox/api.d.mts.map +1 -0
- package/dist/fortnox/api.mjs +750 -0
- package/dist/fortnox/api.mjs.map +1 -0
- package/dist/fortnox/state.d.mts +533 -0
- package/dist/fortnox/state.d.mts.map +1 -0
- package/dist/fortnox/state.mjs +612 -0
- package/dist/fortnox/state.mjs.map +1 -0
- package/dist/fortnox.d.mts +128 -0
- package/dist/fortnox.d.mts.map +1 -0
- package/dist/fortnox.mjs +403 -0
- package/dist/fortnox.mjs.map +1 -0
- package/dist/gateway-evaluate-recordings.d.mts +12 -0
- package/dist/gateway-evaluate-recordings.d.mts.map +1 -0
- package/dist/gateway-evaluate-recordings.mjs +128 -0
- package/dist/gateway-evaluate-recordings.mjs.map +1 -0
- package/dist/gateway.d.mts +272 -0
- package/dist/gateway.d.mts.map +1 -0
- package/dist/gateway.mjs +400 -0
- package/dist/gateway.mjs.map +1 -0
- package/dist/github/api.d.mts +63 -0
- package/dist/github/api.d.mts.map +1 -0
- package/dist/github/api.mjs +527 -0
- package/dist/github/api.mjs.map +1 -0
- package/dist/github/state.d.mts +272 -0
- package/dist/github/state.d.mts.map +1 -0
- package/dist/github/state.mjs +303 -0
- package/dist/github/state.mjs.map +1 -0
- package/dist/github.d.mts +77 -0
- package/dist/github.d.mts.map +1 -0
- package/dist/github.mjs +180 -0
- package/dist/github.mjs.map +1 -0
- package/dist/google/calendar.d.mts +10 -0
- package/dist/google/calendar.d.mts.map +1 -0
- package/dist/google/calendar.mjs +252 -0
- package/dist/google/calendar.mjs.map +1 -0
- package/dist/google/drive.d.mts +8 -0
- package/dist/google/drive.d.mts.map +1 -0
- package/dist/google/drive.mjs +252 -0
- package/dist/google/drive.mjs.map +1 -0
- package/dist/google/gmail.d.mts +10 -0
- package/dist/google/gmail.d.mts.map +1 -0
- package/dist/google/gmail.mjs +591 -0
- package/dist/google/gmail.mjs.map +1 -0
- package/dist/google/shared.d.mts +107 -0
- package/dist/google/shared.d.mts.map +1 -0
- package/dist/google/shared.mjs +146 -0
- package/dist/google/shared.mjs.map +1 -0
- package/dist/google/state.d.mts +385 -0
- package/dist/google/state.d.mts.map +1 -0
- package/dist/google/state.mjs +496 -0
- package/dist/google/state.mjs.map +1 -0
- package/dist/google.d.mts +75 -0
- package/dist/google.d.mts.map +1 -0
- package/dist/google.mjs +210 -0
- package/dist/google.mjs.map +1 -0
- package/dist/linkedin-search/api.d.mts +45 -0
- package/dist/linkedin-search/api.d.mts.map +1 -0
- package/dist/linkedin-search/api.mjs +181 -0
- package/dist/linkedin-search/api.mjs.map +1 -0
- package/dist/linkedin-search/state.d.mts +123 -0
- package/dist/linkedin-search/state.d.mts.map +1 -0
- package/dist/linkedin-search/state.mjs +261 -0
- package/dist/linkedin-search/state.mjs.map +1 -0
- package/dist/linkedin-search.d.mts +69 -0
- package/dist/linkedin-search.d.mts.map +1 -0
- package/dist/linkedin-search.mjs +158 -0
- package/dist/linkedin-search.mjs.map +1 -0
- package/dist/mcp/afloat-recordings.d.mts +8 -0
- package/dist/mcp/afloat-recordings.d.mts.map +1 -0
- package/dist/mcp/afloat-recordings.mjs +918 -0
- package/dist/mcp/afloat-recordings.mjs.map +1 -0
- package/dist/mcp/api.d.mts +45 -0
- package/dist/mcp/api.d.mts.map +1 -0
- package/dist/mcp/api.mjs +609 -0
- package/dist/mcp/api.mjs.map +1 -0
- package/dist/mcp/recordings.d.mts +40 -0
- package/dist/mcp/recordings.d.mts.map +1 -0
- package/dist/mcp/recordings.mjs +2390 -0
- package/dist/mcp/recordings.mjs.map +1 -0
- package/dist/mcp/state.d.mts +86 -0
- package/dist/mcp/state.d.mts.map +1 -0
- package/dist/mcp/state.mjs +98 -0
- package/dist/mcp/state.mjs.map +1 -0
- package/dist/mcp.d.mts +85 -0
- package/dist/mcp.d.mts.map +1 -0
- package/dist/mcp.mjs +264 -0
- package/dist/mcp.mjs.map +1 -0
- package/dist/messages.d.mts +183 -0
- package/dist/messages.d.mts.map +1 -0
- package/dist/messages.mjs +532 -0
- package/dist/messages.mjs.map +1 -0
- package/dist/microsoft/api.d.mts +47 -0
- package/dist/microsoft/api.d.mts.map +1 -0
- package/dist/microsoft/api.mjs +178 -0
- package/dist/microsoft/api.mjs.map +1 -0
- package/dist/microsoft/calendar.d.mts +30 -0
- package/dist/microsoft/calendar.d.mts.map +1 -0
- package/dist/microsoft/calendar.mjs +271 -0
- package/dist/microsoft/calendar.mjs.map +1 -0
- package/dist/microsoft/drive.d.mts +36 -0
- package/dist/microsoft/drive.d.mts.map +1 -0
- package/dist/microsoft/drive.mjs +298 -0
- package/dist/microsoft/drive.mjs.map +1 -0
- package/dist/microsoft/graph.d.mts +198 -0
- package/dist/microsoft/graph.d.mts.map +1 -0
- package/dist/microsoft/graph.mjs +264 -0
- package/dist/microsoft/graph.mjs.map +1 -0
- package/dist/microsoft/mail.d.mts +48 -0
- package/dist/microsoft/mail.d.mts.map +1 -0
- package/dist/microsoft/mail.mjs +488 -0
- package/dist/microsoft/mail.mjs.map +1 -0
- package/dist/microsoft/state.d.mts +480 -0
- package/dist/microsoft/state.d.mts.map +1 -0
- package/dist/microsoft/state.mjs +625 -0
- package/dist/microsoft/state.mjs.map +1 -0
- package/dist/microsoft.d.mts +168 -0
- package/dist/microsoft.d.mts.map +1 -0
- package/dist/microsoft.mjs +483 -0
- package/dist/microsoft.mjs.map +1 -0
- package/dist/node.d.mts +47 -0
- package/dist/node.d.mts.map +1 -0
- package/dist/node.mjs +178 -0
- package/dist/node.mjs.map +1 -0
- package/dist/notion/api.d.mts +51 -0
- package/dist/notion/api.d.mts.map +1 -0
- package/dist/notion/api.mjs +507 -0
- package/dist/notion/api.mjs.map +1 -0
- package/dist/notion/state.d.mts +329 -0
- package/dist/notion/state.d.mts.map +1 -0
- package/dist/notion/state.mjs +432 -0
- package/dist/notion/state.mjs.map +1 -0
- package/dist/notion.d.mts +72 -0
- package/dist/notion.d.mts.map +1 -0
- package/dist/notion.mjs +127 -0
- package/dist/notion.mjs.map +1 -0
- package/dist/openai.d.mts +165 -0
- package/dist/openai.d.mts.map +1 -0
- package/dist/openai.mjs +141 -0
- package/dist/openai.mjs.map +1 -0
- package/dist/opencode-recordings.d.mts +7 -0
- package/dist/opencode-recordings.d.mts.map +1 -0
- package/dist/opencode-recordings.mjs +222 -0
- package/dist/opencode-recordings.mjs.map +1 -0
- package/dist/opencode.d.mts +70 -0
- package/dist/opencode.d.mts.map +1 -0
- package/dist/opencode.mjs +217 -0
- package/dist/opencode.mjs.map +1 -0
- package/dist/r2-fixtures.d.mts +36 -0
- package/dist/r2-fixtures.d.mts.map +1 -0
- package/dist/r2-fixtures.mjs +245 -0
- package/dist/r2-fixtures.mjs.map +1 -0
- package/dist/r2-guard.d.mts +43 -0
- package/dist/r2-guard.d.mts.map +1 -0
- package/dist/r2-guard.mjs +216 -0
- package/dist/r2-guard.mjs.map +1 -0
- package/dist/r2.d.mts +166 -0
- package/dist/r2.d.mts.map +1 -0
- package/dist/r2.mjs +517 -0
- package/dist/r2.mjs.map +1 -0
- package/dist/responses.d.mts +231 -0
- package/dist/responses.d.mts.map +1 -0
- package/dist/responses.mjs +556 -0
- package/dist/responses.mjs.map +1 -0
- package/dist/route-evidence.d.mts +45 -0
- package/dist/route-evidence.d.mts.map +1 -0
- package/dist/route-evidence.mjs +56 -0
- package/dist/route-evidence.mjs.map +1 -0
- package/dist/router.d.mts +93 -0
- package/dist/router.d.mts.map +1 -0
- package/dist/router.mjs +259 -0
- package/dist/router.mjs.map +1 -0
- package/dist/stateful-core.d.mts +17 -0
- package/dist/stateful-core.d.mts.map +1 -0
- package/dist/stateful-core.mjs +41 -0
- package/dist/stateful-core.mjs.map +1 -0
- package/dist/stateful-emulator.d.mts +578 -0
- package/dist/stateful-emulator.d.mts.map +1 -0
- package/dist/stateful-emulator.mjs +1248 -0
- package/dist/stateful-emulator.mjs.map +1 -0
- package/dist/stateful-secrets.d.mts +84 -0
- package/dist/stateful-secrets.d.mts.map +1 -0
- package/dist/stateful-secrets.mjs +216 -0
- package/dist/stateful-secrets.mjs.map +1 -0
- package/dist/subscription-usage-recordings.d.mts +9 -0
- package/dist/subscription-usage-recordings.d.mts.map +1 -0
- package/dist/subscription-usage-recordings.mjs +53 -0
- package/dist/subscription-usage-recordings.mjs.map +1 -0
- package/dist/subscription-usage.d.mts +53 -0
- package/dist/subscription-usage.d.mts.map +1 -0
- package/dist/subscription-usage.mjs +21 -0
- package/dist/subscription-usage.mjs.map +1 -0
- package/dist/telegram/api.d.mts +34 -0
- package/dist/telegram/api.d.mts.map +1 -0
- package/dist/telegram/api.mjs +257 -0
- package/dist/telegram/api.mjs.map +1 -0
- package/dist/telegram/state.d.mts +128 -0
- package/dist/telegram/state.d.mts.map +1 -0
- package/dist/telegram/state.mjs +154 -0
- package/dist/telegram/state.mjs.map +1 -0
- package/dist/telegram.d.mts +62 -0
- package/dist/telegram.d.mts.map +1 -0
- package/dist/telegram.mjs +127 -0
- package/dist/telegram.mjs.map +1 -0
- package/dist/todoist/api.d.mts +55 -0
- package/dist/todoist/api.d.mts.map +1 -0
- package/dist/todoist/api.mjs +415 -0
- package/dist/todoist/api.mjs.map +1 -0
- package/dist/todoist/state.d.mts +275 -0
- package/dist/todoist/state.d.mts.map +1 -0
- package/dist/todoist/state.mjs +345 -0
- package/dist/todoist/state.mjs.map +1 -0
- package/dist/todoist.d.mts +68 -0
- package/dist/todoist.d.mts.map +1 -0
- package/dist/todoist.mjs +181 -0
- package/dist/todoist.mjs.map +1 -0
- package/dist/xai.d.mts +267 -0
- package/dist/xai.d.mts.map +1 -0
- package/dist/xai.mjs +252 -0
- package/dist/xai.mjs.map +1 -0
- package/package.json +157 -0
- package/src/anthropic.ts +289 -0
- package/src/chat-completions.ts +924 -0
- package/src/codex.ts +296 -0
- package/src/dropbox/api.ts +1084 -0
- package/src/dropbox/state.ts +364 -0
- package/src/dropbox.ts +203 -0
- package/src/email-fixtures.ts +1297 -0
- package/src/email.ts +1108 -0
- package/src/emulator-compose.ts +147 -0
- package/src/emulator-http.ts +184 -0
- package/src/emulator-kernel.ts +844 -0
- package/src/fixture-route.ts +561 -0
- package/src/fortnox/api.ts +1352 -0
- package/src/fortnox/state.ts +798 -0
- package/src/fortnox.ts +801 -0
- package/src/gateway-evaluate-recordings.ts +153 -0
- package/src/gateway.ts +530 -0
- package/src/github/api.ts +986 -0
- package/src/github/state.ts +439 -0
- package/src/github.ts +271 -0
- package/src/google/calendar.ts +486 -0
- package/src/google/drive.ts +471 -0
- package/src/google/gmail.ts +1011 -0
- package/src/google/shared.ts +321 -0
- package/src/google/state.ts +686 -0
- package/src/google.ts +298 -0
- package/src/linkedin-search/api.ts +363 -0
- package/src/linkedin-search/state.ts +373 -0
- package/src/linkedin-search.ts +241 -0
- package/src/mcp/afloat-recordings.ts +1040 -0
- package/src/mcp/api.ts +1105 -0
- package/src/mcp/recordings.ts +2665 -0
- package/src/mcp/state.ts +144 -0
- package/src/mcp.ts +364 -0
- package/src/messages.ts +844 -0
- package/src/microsoft/api.ts +426 -0
- package/src/microsoft/calendar.ts +491 -0
- package/src/microsoft/drive.ts +541 -0
- package/src/microsoft/graph.ts +550 -0
- package/src/microsoft/mail.ts +833 -0
- package/src/microsoft/state.ts +822 -0
- package/src/microsoft.ts +982 -0
- package/src/node.ts +293 -0
- package/src/notion/api.ts +976 -0
- package/src/notion/state.ts +512 -0
- package/src/notion.ts +210 -0
- package/src/openai.ts +198 -0
- package/src/opencode-recordings.ts +257 -0
- package/src/opencode.ts +271 -0
- package/src/r2-fixtures.ts +295 -0
- package/src/r2-guard.ts +324 -0
- package/src/r2.ts +890 -0
- package/src/responses.ts +901 -0
- package/src/route-evidence.ts +90 -0
- package/src/router.ts +490 -0
- package/src/stateful-core.ts +70 -0
- package/src/stateful-emulator.ts +2620 -0
- package/src/stateful-secrets.ts +299 -0
- package/src/subscription-usage-recordings.ts +77 -0
- package/src/subscription-usage.ts +68 -0
- package/src/telegram/api.ts +437 -0
- package/src/telegram/state.ts +229 -0
- package/src/telegram.ts +227 -0
- package/src/todoist/api.ts +736 -0
- package/src/todoist/state.ts +456 -0
- package/src/todoist.ts +316 -0
- package/src/xai.ts +341 -0
|
@@ -0,0 +1,1040 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The derived Afloat MCP conformance fixtures, copied as data (internal; never imported from
|
|
3
|
+
* `@yolk-sdk/connectors`): the eight `WireFixture`s of `afloatMcpConformanceFixtures` in
|
|
4
|
+
* `@yolk-sdk/connectors/afloat/conformance`, in its order, on the provider endpoint
|
|
5
|
+
* `https://useafloat.com/mcp` (stateless `2026-07-28`, JSON answers, no session). They are derived
|
|
6
|
+
* from the provider's source, not recorded from a live service (see their notes).
|
|
7
|
+
* `test/mcp.test.ts` fails when this copy drifts from the source and replays every exchange
|
|
8
|
+
* against the emulator byte for byte. Every value is synthetic; no fixture records
|
|
9
|
+
* `authorization`.
|
|
10
|
+
*
|
|
11
|
+
* @experimental
|
|
12
|
+
*/
|
|
13
|
+
import type { McpRecordedFixture } from './recordings.ts'
|
|
14
|
+
|
|
15
|
+
/** Every Afloat MCP fixture, in the order of `afloatMcpConformanceFixtures`. */
|
|
16
|
+
export const mcpEmulatorAfloatFixtures: ReadonlyArray<McpRecordedFixture> = [
|
|
17
|
+
{
|
|
18
|
+
id: 'mcp.negotiation.era.afloat.synthetic',
|
|
19
|
+
caseId: 'mcp.negotiation.era',
|
|
20
|
+
evidence: 'unverified',
|
|
21
|
+
recordedAt: '2026-10-02',
|
|
22
|
+
account: 'synthetic',
|
|
23
|
+
endpoint: 'https://useafloat.com/mcp',
|
|
24
|
+
note: 'server/discover answered with supportedVersions ["2026-07-28"]; the client then lists tools statelessly. Derived from the provider source (owner-supplied), not a live recording: the envelopes are the pinned official MCP server SDK 2.0.0 run in-process with the provider handler options, the listing is the published tool subset, and the results follow the provider output builders over synthetic data.',
|
|
25
|
+
exchanges: [
|
|
26
|
+
{
|
|
27
|
+
request: {
|
|
28
|
+
method: 'POST',
|
|
29
|
+
url: 'https://useafloat.com/mcp',
|
|
30
|
+
headers: {
|
|
31
|
+
accept: 'application/json, text/event-stream',
|
|
32
|
+
'content-type': 'application/json',
|
|
33
|
+
'mcp-method': 'server/discover',
|
|
34
|
+
'mcp-protocol-version': '2026-07-28'
|
|
35
|
+
},
|
|
36
|
+
body: {
|
|
37
|
+
jsonrpc: '2.0',
|
|
38
|
+
id: 'server-discover-probe-1',
|
|
39
|
+
method: 'server/discover',
|
|
40
|
+
params: {
|
|
41
|
+
_meta: {
|
|
42
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
43
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
44
|
+
name: 'yolk',
|
|
45
|
+
version: '0.1.0'
|
|
46
|
+
},
|
|
47
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
},
|
|
52
|
+
response: {
|
|
53
|
+
status: 200,
|
|
54
|
+
headers: {
|
|
55
|
+
'content-type': 'application/json'
|
|
56
|
+
},
|
|
57
|
+
body: '{"result":{"supportedVersions":["2026-07-28"],"capabilities":{"tools":{"listChanged":false}},"instructions":"Tools for reading and managing business records.","resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":"server-discover-probe-1"}'
|
|
58
|
+
}
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
request: {
|
|
62
|
+
method: 'POST',
|
|
63
|
+
url: 'https://useafloat.com/mcp',
|
|
64
|
+
headers: {
|
|
65
|
+
accept: 'application/json, text/event-stream',
|
|
66
|
+
'content-type': 'application/json',
|
|
67
|
+
'mcp-method': 'tools/list',
|
|
68
|
+
'mcp-protocol-version': '2026-07-28'
|
|
69
|
+
},
|
|
70
|
+
body: {
|
|
71
|
+
jsonrpc: '2.0',
|
|
72
|
+
id: 0,
|
|
73
|
+
method: 'tools/list',
|
|
74
|
+
params: {
|
|
75
|
+
_meta: {
|
|
76
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
77
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
78
|
+
name: 'yolk',
|
|
79
|
+
version: '0.1.0'
|
|
80
|
+
},
|
|
81
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
},
|
|
86
|
+
response: {
|
|
87
|
+
status: 200,
|
|
88
|
+
headers: {
|
|
89
|
+
'content-type': 'application/json'
|
|
90
|
+
},
|
|
91
|
+
body: '{"result":{"tools":[{"name":"list-invoices","title":"List invoices","description":"List issued invoices, one page at a time, optionally filtered by search text or payment status.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"page":{"description":"a positive number","exclusiveMinimum":0,"title":"positive","type":"integer"},"search":{"type":"string"},"size":{"enum":[10,25,50,100],"type":"number"},"status":{"enum":["all","paid","pending","overdue","voided"],"type":"string"}},"required":[],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"items":{"items":{"additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence":{"additionalProperties":false,"properties":{"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["prefix","suffix"],"type":"object"},"status":{"enum":["ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","purchaseOrder","notes","customer","sequence","updatedAt"],"type":"object"},"type":"array"},"totalCount":{"description":"an integer","title":"int","type":"integer"}},"required":["items","totalCount"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-invoice","title":"Get invoice","description":"Read one invoice by id, with its line items, customer, vendor, and numbering sequence.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"createdAt":{"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"items":{"items":{"additionalProperties":false,"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"quantity":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"title":{"type":"string"},"totalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"unitValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"}},"required":["id","title","description","quantity","unitValue","taxPercentage","totalValue"],"type":"object"},"type":"array"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"secondTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"sequence":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["id","name","prefix","suffix"],"type":"object"},"shippingTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"shippingValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"status":{"enum":["DRAFT","ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"},"vendor":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"paymentInfo":{"anyOf":[{"type":"string"},{"type":"null"}]},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact","paymentInfo"],"type":"object"},"voidedDate":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","secondTaxPercentage","shippingValue","shippingTaxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","voidedDate","purchaseOrder","notes","customer","vendor","sequence","items","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-tax-return-download","title":"Get tax return download","description":"Issue a short-lived download grant for a completed tax-return archive.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"taxReturnId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["taxReturnId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-logo-download","title":"Get logo download","description":"Issue a short-lived download grant for a logo.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"logoId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["logoId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/logo\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/logo\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"create-receipt-upload","title":"Create receipt upload","description":"Start a receipt upload: answers a short-lived upload URL and the headers the upload must send.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"checksumSha256":{"description":"a string matching the pattern ^[A-Za-z0-9+/]{43}=$","maxLength":44,"minLength":44,"pattern":"^[A-Za-z0-9+/]{43}=$","title":"length(44)","type":"string"},"contentLength":{"description":"a number between 1 and 2147483647","maximum":2147483647,"minimum":1,"title":"between(1, 2147483647)","type":"integer"},"contentType":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"}},"required":["contentType","contentLength"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"requiredHeaders":{"additionalProperties":false,"properties":{"content-length":{"description":"a string matching the pattern ^\\\\d+$","pattern":"^\\\\d+$","type":"string"},"content-type":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"},"x-amz-checksum-sha256":{"type":"string"}},"required":["content-type","content-length"],"type":"object"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadUrl":{"description":"a string at least 1 character(s) long","minLength":1,"title":"minLength(1)","type":"string"}},"required":["uploadIntentId","uploadUrl","expiresAt","requiredHeaders"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"complete-receipt-upload","title":"Complete receipt upload","description":"Finish a receipt upload and attach the uploaded file to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId","uploadIntentId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"createdAt":{"type":"string"},"hasReceipt":{"type":"boolean"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"payee":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"receiptCurrency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"receiptSubtotalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"receiptValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"rounding":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"enum":["PAID","PENDING"],"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","status","receiptSubtotalValue","receiptValue","receiptCurrency","taxPercentage","paymentDate","paymentValue","paymentCurrency","rounding","hasReceipt","payee","tags","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-receipt-download","title":"Get receipt download","description":"Issue a short-lived download grant for the receipt attached to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/receipt\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/receipt\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-invoice-pdf","title":"Get invoice PDF","description":"Issue a short-lived download grant for an invoice PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-quote-pdf","title":"Get quote PDF","description":"Issue a short-lived download grant for a quote PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"quoteId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["quoteId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}}],"resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":0}'
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
]
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
id: 'mcp.modern.stateless.afloat.synthetic',
|
|
98
|
+
caseId: 'mcp.modern.stateless',
|
|
99
|
+
evidence: 'unverified',
|
|
100
|
+
recordedAt: '2026-10-02',
|
|
101
|
+
account: 'synthetic',
|
|
102
|
+
endpoint: 'https://useafloat.com/mcp',
|
|
103
|
+
note: 'A stateless listing and an absent-tool call: routing headers on every request, no session id, results complete. Derived from the provider source (owner-supplied), not a live recording: the envelopes are the pinned official MCP server SDK 2.0.0 run in-process with the provider handler options, the listing is the published tool subset, and the results follow the provider output builders over synthetic data.',
|
|
104
|
+
exchanges: [
|
|
105
|
+
{
|
|
106
|
+
request: {
|
|
107
|
+
method: 'POST',
|
|
108
|
+
url: 'https://useafloat.com/mcp',
|
|
109
|
+
headers: {
|
|
110
|
+
accept: 'application/json, text/event-stream',
|
|
111
|
+
'content-type': 'application/json',
|
|
112
|
+
'mcp-method': 'server/discover',
|
|
113
|
+
'mcp-protocol-version': '2026-07-28'
|
|
114
|
+
},
|
|
115
|
+
body: {
|
|
116
|
+
jsonrpc: '2.0',
|
|
117
|
+
id: 'server-discover-probe-1',
|
|
118
|
+
method: 'server/discover',
|
|
119
|
+
params: {
|
|
120
|
+
_meta: {
|
|
121
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
122
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
123
|
+
name: 'yolk',
|
|
124
|
+
version: '0.1.0'
|
|
125
|
+
},
|
|
126
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
},
|
|
131
|
+
response: {
|
|
132
|
+
status: 200,
|
|
133
|
+
headers: {
|
|
134
|
+
'content-type': 'application/json'
|
|
135
|
+
},
|
|
136
|
+
body: '{"result":{"supportedVersions":["2026-07-28"],"capabilities":{"tools":{"listChanged":false}},"instructions":"Tools for reading and managing business records.","resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":"server-discover-probe-1"}'
|
|
137
|
+
}
|
|
138
|
+
},
|
|
139
|
+
{
|
|
140
|
+
request: {
|
|
141
|
+
method: 'POST',
|
|
142
|
+
url: 'https://useafloat.com/mcp',
|
|
143
|
+
headers: {
|
|
144
|
+
accept: 'application/json, text/event-stream',
|
|
145
|
+
'content-type': 'application/json',
|
|
146
|
+
'mcp-method': 'tools/list',
|
|
147
|
+
'mcp-protocol-version': '2026-07-28'
|
|
148
|
+
},
|
|
149
|
+
body: {
|
|
150
|
+
jsonrpc: '2.0',
|
|
151
|
+
id: 0,
|
|
152
|
+
method: 'tools/list',
|
|
153
|
+
params: {
|
|
154
|
+
_meta: {
|
|
155
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
156
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
157
|
+
name: 'yolk',
|
|
158
|
+
version: '0.1.0'
|
|
159
|
+
},
|
|
160
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
},
|
|
165
|
+
response: {
|
|
166
|
+
status: 200,
|
|
167
|
+
headers: {
|
|
168
|
+
'content-type': 'application/json'
|
|
169
|
+
},
|
|
170
|
+
body: '{"result":{"tools":[{"name":"list-invoices","title":"List invoices","description":"List issued invoices, one page at a time, optionally filtered by search text or payment status.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"page":{"description":"a positive number","exclusiveMinimum":0,"title":"positive","type":"integer"},"search":{"type":"string"},"size":{"enum":[10,25,50,100],"type":"number"},"status":{"enum":["all","paid","pending","overdue","voided"],"type":"string"}},"required":[],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"items":{"items":{"additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence":{"additionalProperties":false,"properties":{"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["prefix","suffix"],"type":"object"},"status":{"enum":["ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","purchaseOrder","notes","customer","sequence","updatedAt"],"type":"object"},"type":"array"},"totalCount":{"description":"an integer","title":"int","type":"integer"}},"required":["items","totalCount"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-invoice","title":"Get invoice","description":"Read one invoice by id, with its line items, customer, vendor, and numbering sequence.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"createdAt":{"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"items":{"items":{"additionalProperties":false,"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"quantity":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"title":{"type":"string"},"totalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"unitValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"}},"required":["id","title","description","quantity","unitValue","taxPercentage","totalValue"],"type":"object"},"type":"array"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"secondTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"sequence":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["id","name","prefix","suffix"],"type":"object"},"shippingTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"shippingValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"status":{"enum":["DRAFT","ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"},"vendor":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"paymentInfo":{"anyOf":[{"type":"string"},{"type":"null"}]},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact","paymentInfo"],"type":"object"},"voidedDate":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","secondTaxPercentage","shippingValue","shippingTaxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","voidedDate","purchaseOrder","notes","customer","vendor","sequence","items","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-tax-return-download","title":"Get tax return download","description":"Issue a short-lived download grant for a completed tax-return archive.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"taxReturnId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["taxReturnId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-logo-download","title":"Get logo download","description":"Issue a short-lived download grant for a logo.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"logoId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["logoId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/logo\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/logo\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"create-receipt-upload","title":"Create receipt upload","description":"Start a receipt upload: answers a short-lived upload URL and the headers the upload must send.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"checksumSha256":{"description":"a string matching the pattern ^[A-Za-z0-9+/]{43}=$","maxLength":44,"minLength":44,"pattern":"^[A-Za-z0-9+/]{43}=$","title":"length(44)","type":"string"},"contentLength":{"description":"a number between 1 and 2147483647","maximum":2147483647,"minimum":1,"title":"between(1, 2147483647)","type":"integer"},"contentType":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"}},"required":["contentType","contentLength"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"requiredHeaders":{"additionalProperties":false,"properties":{"content-length":{"description":"a string matching the pattern ^\\\\d+$","pattern":"^\\\\d+$","type":"string"},"content-type":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"},"x-amz-checksum-sha256":{"type":"string"}},"required":["content-type","content-length"],"type":"object"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadUrl":{"description":"a string at least 1 character(s) long","minLength":1,"title":"minLength(1)","type":"string"}},"required":["uploadIntentId","uploadUrl","expiresAt","requiredHeaders"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"complete-receipt-upload","title":"Complete receipt upload","description":"Finish a receipt upload and attach the uploaded file to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId","uploadIntentId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"createdAt":{"type":"string"},"hasReceipt":{"type":"boolean"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"payee":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"receiptCurrency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"receiptSubtotalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"receiptValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"rounding":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"enum":["PAID","PENDING"],"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","status","receiptSubtotalValue","receiptValue","receiptCurrency","taxPercentage","paymentDate","paymentValue","paymentCurrency","rounding","hasReceipt","payee","tags","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-receipt-download","title":"Get receipt download","description":"Issue a short-lived download grant for the receipt attached to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/receipt\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/receipt\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-invoice-pdf","title":"Get invoice PDF","description":"Issue a short-lived download grant for an invoice PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-quote-pdf","title":"Get quote PDF","description":"Issue a short-lived download grant for a quote PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"quoteId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["quoteId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}}],"resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":0}'
|
|
171
|
+
}
|
|
172
|
+
},
|
|
173
|
+
{
|
|
174
|
+
request: {
|
|
175
|
+
method: 'POST',
|
|
176
|
+
url: 'https://useafloat.com/mcp',
|
|
177
|
+
headers: {
|
|
178
|
+
accept: 'application/json, text/event-stream',
|
|
179
|
+
'content-type': 'application/json',
|
|
180
|
+
'mcp-method': 'server/discover',
|
|
181
|
+
'mcp-protocol-version': '2026-07-28'
|
|
182
|
+
},
|
|
183
|
+
body: {
|
|
184
|
+
jsonrpc: '2.0',
|
|
185
|
+
id: 'server-discover-probe-1',
|
|
186
|
+
method: 'server/discover',
|
|
187
|
+
params: {
|
|
188
|
+
_meta: {
|
|
189
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
190
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
191
|
+
name: 'yolk',
|
|
192
|
+
version: '0.1.0'
|
|
193
|
+
},
|
|
194
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
},
|
|
199
|
+
response: {
|
|
200
|
+
status: 200,
|
|
201
|
+
headers: {
|
|
202
|
+
'content-type': 'application/json'
|
|
203
|
+
},
|
|
204
|
+
body: '{"result":{"supportedVersions":["2026-07-28"],"capabilities":{"tools":{"listChanged":false}},"instructions":"Tools for reading and managing business records.","resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":"server-discover-probe-1"}'
|
|
205
|
+
}
|
|
206
|
+
},
|
|
207
|
+
{
|
|
208
|
+
request: {
|
|
209
|
+
method: 'POST',
|
|
210
|
+
url: 'https://useafloat.com/mcp',
|
|
211
|
+
headers: {
|
|
212
|
+
accept: 'application/json, text/event-stream',
|
|
213
|
+
'content-type': 'application/json',
|
|
214
|
+
'mcp-method': 'tools/list',
|
|
215
|
+
'mcp-protocol-version': '2026-07-28'
|
|
216
|
+
},
|
|
217
|
+
body: {
|
|
218
|
+
jsonrpc: '2.0',
|
|
219
|
+
id: 0,
|
|
220
|
+
method: 'tools/list',
|
|
221
|
+
params: {
|
|
222
|
+
_meta: {
|
|
223
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
224
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
225
|
+
name: 'yolk',
|
|
226
|
+
version: '0.1.0'
|
|
227
|
+
},
|
|
228
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
},
|
|
233
|
+
response: {
|
|
234
|
+
status: 200,
|
|
235
|
+
headers: {
|
|
236
|
+
'content-type': 'application/json'
|
|
237
|
+
},
|
|
238
|
+
body: '{"result":{"tools":[{"name":"list-invoices","title":"List invoices","description":"List issued invoices, one page at a time, optionally filtered by search text or payment status.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"page":{"description":"a positive number","exclusiveMinimum":0,"title":"positive","type":"integer"},"search":{"type":"string"},"size":{"enum":[10,25,50,100],"type":"number"},"status":{"enum":["all","paid","pending","overdue","voided"],"type":"string"}},"required":[],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"items":{"items":{"additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence":{"additionalProperties":false,"properties":{"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["prefix","suffix"],"type":"object"},"status":{"enum":["ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","purchaseOrder","notes","customer","sequence","updatedAt"],"type":"object"},"type":"array"},"totalCount":{"description":"an integer","title":"int","type":"integer"}},"required":["items","totalCount"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-invoice","title":"Get invoice","description":"Read one invoice by id, with its line items, customer, vendor, and numbering sequence.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"createdAt":{"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"items":{"items":{"additionalProperties":false,"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"quantity":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"title":{"type":"string"},"totalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"unitValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"}},"required":["id","title","description","quantity","unitValue","taxPercentage","totalValue"],"type":"object"},"type":"array"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"secondTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"sequence":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["id","name","prefix","suffix"],"type":"object"},"shippingTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"shippingValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"status":{"enum":["DRAFT","ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"},"vendor":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"paymentInfo":{"anyOf":[{"type":"string"},{"type":"null"}]},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact","paymentInfo"],"type":"object"},"voidedDate":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","secondTaxPercentage","shippingValue","shippingTaxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","voidedDate","purchaseOrder","notes","customer","vendor","sequence","items","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-tax-return-download","title":"Get tax return download","description":"Issue a short-lived download grant for a completed tax-return archive.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"taxReturnId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["taxReturnId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-logo-download","title":"Get logo download","description":"Issue a short-lived download grant for a logo.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"logoId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["logoId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/logo\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/logo\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"create-receipt-upload","title":"Create receipt upload","description":"Start a receipt upload: answers a short-lived upload URL and the headers the upload must send.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"checksumSha256":{"description":"a string matching the pattern ^[A-Za-z0-9+/]{43}=$","maxLength":44,"minLength":44,"pattern":"^[A-Za-z0-9+/]{43}=$","title":"length(44)","type":"string"},"contentLength":{"description":"a number between 1 and 2147483647","maximum":2147483647,"minimum":1,"title":"between(1, 2147483647)","type":"integer"},"contentType":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"}},"required":["contentType","contentLength"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"requiredHeaders":{"additionalProperties":false,"properties":{"content-length":{"description":"a string matching the pattern ^\\\\d+$","pattern":"^\\\\d+$","type":"string"},"content-type":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"},"x-amz-checksum-sha256":{"type":"string"}},"required":["content-type","content-length"],"type":"object"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadUrl":{"description":"a string at least 1 character(s) long","minLength":1,"title":"minLength(1)","type":"string"}},"required":["uploadIntentId","uploadUrl","expiresAt","requiredHeaders"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"complete-receipt-upload","title":"Complete receipt upload","description":"Finish a receipt upload and attach the uploaded file to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId","uploadIntentId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"createdAt":{"type":"string"},"hasReceipt":{"type":"boolean"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"payee":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"receiptCurrency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"receiptSubtotalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"receiptValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"rounding":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"enum":["PAID","PENDING"],"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","status","receiptSubtotalValue","receiptValue","receiptCurrency","taxPercentage","paymentDate","paymentValue","paymentCurrency","rounding","hasReceipt","payee","tags","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-receipt-download","title":"Get receipt download","description":"Issue a short-lived download grant for the receipt attached to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/receipt\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/receipt\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-invoice-pdf","title":"Get invoice PDF","description":"Issue a short-lived download grant for an invoice PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-quote-pdf","title":"Get quote PDF","description":"Issue a short-lived download grant for a quote PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"quoteId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["quoteId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}}],"resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":0}'
|
|
239
|
+
}
|
|
240
|
+
},
|
|
241
|
+
{
|
|
242
|
+
request: {
|
|
243
|
+
method: 'POST',
|
|
244
|
+
url: 'https://useafloat.com/mcp',
|
|
245
|
+
headers: {
|
|
246
|
+
accept: 'application/json, text/event-stream',
|
|
247
|
+
'content-type': 'application/json',
|
|
248
|
+
'mcp-method': 'tools/call',
|
|
249
|
+
'mcp-protocol-version': '2026-07-28',
|
|
250
|
+
'mcp-name': 'yolk_conformance_absent'
|
|
251
|
+
},
|
|
252
|
+
body: {
|
|
253
|
+
jsonrpc: '2.0',
|
|
254
|
+
id: 1,
|
|
255
|
+
method: 'tools/call',
|
|
256
|
+
params: {
|
|
257
|
+
name: 'yolk_conformance_absent',
|
|
258
|
+
arguments: {},
|
|
259
|
+
_meta: {
|
|
260
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
261
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
262
|
+
name: 'yolk',
|
|
263
|
+
version: '0.1.0'
|
|
264
|
+
},
|
|
265
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
266
|
+
}
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
},
|
|
270
|
+
response: {
|
|
271
|
+
status: 200,
|
|
272
|
+
headers: {
|
|
273
|
+
'content-type': 'application/json'
|
|
274
|
+
},
|
|
275
|
+
body: '{"jsonrpc":"2.0","id":1,"error":{"code":-32602,"message":"Requested tool was not found"}}'
|
|
276
|
+
}
|
|
277
|
+
}
|
|
278
|
+
]
|
|
279
|
+
},
|
|
280
|
+
{
|
|
281
|
+
id: 'mcp.transport.response-encoding.afloat.synthetic',
|
|
282
|
+
caseId: 'mcp.transport.response-encoding',
|
|
283
|
+
evidence: 'unverified',
|
|
284
|
+
recordedAt: '2026-10-02',
|
|
285
|
+
account: 'synthetic',
|
|
286
|
+
endpoint: 'https://useafloat.com/mcp',
|
|
287
|
+
note: 'Every answer is application/json holding the response to its request. Derived from the provider source (owner-supplied), not a live recording: the envelopes are the pinned official MCP server SDK 2.0.0 run in-process with the provider handler options, the listing is the published tool subset, and the results follow the provider output builders over synthetic data.',
|
|
288
|
+
exchanges: [
|
|
289
|
+
{
|
|
290
|
+
request: {
|
|
291
|
+
method: 'POST',
|
|
292
|
+
url: 'https://useafloat.com/mcp',
|
|
293
|
+
headers: {
|
|
294
|
+
accept: 'application/json, text/event-stream',
|
|
295
|
+
'content-type': 'application/json',
|
|
296
|
+
'mcp-method': 'server/discover',
|
|
297
|
+
'mcp-protocol-version': '2026-07-28'
|
|
298
|
+
},
|
|
299
|
+
body: {
|
|
300
|
+
jsonrpc: '2.0',
|
|
301
|
+
id: 'server-discover-probe-1',
|
|
302
|
+
method: 'server/discover',
|
|
303
|
+
params: {
|
|
304
|
+
_meta: {
|
|
305
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
306
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
307
|
+
name: 'yolk',
|
|
308
|
+
version: '0.1.0'
|
|
309
|
+
},
|
|
310
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
311
|
+
}
|
|
312
|
+
}
|
|
313
|
+
}
|
|
314
|
+
},
|
|
315
|
+
response: {
|
|
316
|
+
status: 200,
|
|
317
|
+
headers: {
|
|
318
|
+
'content-type': 'application/json'
|
|
319
|
+
},
|
|
320
|
+
body: '{"result":{"supportedVersions":["2026-07-28"],"capabilities":{"tools":{"listChanged":false}},"instructions":"Tools for reading and managing business records.","resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":"server-discover-probe-1"}'
|
|
321
|
+
}
|
|
322
|
+
},
|
|
323
|
+
{
|
|
324
|
+
request: {
|
|
325
|
+
method: 'POST',
|
|
326
|
+
url: 'https://useafloat.com/mcp',
|
|
327
|
+
headers: {
|
|
328
|
+
accept: 'application/json, text/event-stream',
|
|
329
|
+
'content-type': 'application/json',
|
|
330
|
+
'mcp-method': 'tools/list',
|
|
331
|
+
'mcp-protocol-version': '2026-07-28'
|
|
332
|
+
},
|
|
333
|
+
body: {
|
|
334
|
+
jsonrpc: '2.0',
|
|
335
|
+
id: 0,
|
|
336
|
+
method: 'tools/list',
|
|
337
|
+
params: {
|
|
338
|
+
_meta: {
|
|
339
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
340
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
341
|
+
name: 'yolk',
|
|
342
|
+
version: '0.1.0'
|
|
343
|
+
},
|
|
344
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
345
|
+
}
|
|
346
|
+
}
|
|
347
|
+
}
|
|
348
|
+
},
|
|
349
|
+
response: {
|
|
350
|
+
status: 200,
|
|
351
|
+
headers: {
|
|
352
|
+
'content-type': 'application/json'
|
|
353
|
+
},
|
|
354
|
+
body: '{"result":{"tools":[{"name":"list-invoices","title":"List invoices","description":"List issued invoices, one page at a time, optionally filtered by search text or payment status.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"page":{"description":"a positive number","exclusiveMinimum":0,"title":"positive","type":"integer"},"search":{"type":"string"},"size":{"enum":[10,25,50,100],"type":"number"},"status":{"enum":["all","paid","pending","overdue","voided"],"type":"string"}},"required":[],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"items":{"items":{"additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence":{"additionalProperties":false,"properties":{"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["prefix","suffix"],"type":"object"},"status":{"enum":["ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","purchaseOrder","notes","customer","sequence","updatedAt"],"type":"object"},"type":"array"},"totalCount":{"description":"an integer","title":"int","type":"integer"}},"required":["items","totalCount"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-invoice","title":"Get invoice","description":"Read one invoice by id, with its line items, customer, vendor, and numbering sequence.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"createdAt":{"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"items":{"items":{"additionalProperties":false,"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"quantity":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"title":{"type":"string"},"totalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"unitValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"}},"required":["id","title","description","quantity","unitValue","taxPercentage","totalValue"],"type":"object"},"type":"array"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"secondTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"sequence":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["id","name","prefix","suffix"],"type":"object"},"shippingTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"shippingValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"status":{"enum":["DRAFT","ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"},"vendor":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"paymentInfo":{"anyOf":[{"type":"string"},{"type":"null"}]},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact","paymentInfo"],"type":"object"},"voidedDate":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","secondTaxPercentage","shippingValue","shippingTaxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","voidedDate","purchaseOrder","notes","customer","vendor","sequence","items","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-tax-return-download","title":"Get tax return download","description":"Issue a short-lived download grant for a completed tax-return archive.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"taxReturnId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["taxReturnId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-logo-download","title":"Get logo download","description":"Issue a short-lived download grant for a logo.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"logoId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["logoId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/logo\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/logo\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"create-receipt-upload","title":"Create receipt upload","description":"Start a receipt upload: answers a short-lived upload URL and the headers the upload must send.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"checksumSha256":{"description":"a string matching the pattern ^[A-Za-z0-9+/]{43}=$","maxLength":44,"minLength":44,"pattern":"^[A-Za-z0-9+/]{43}=$","title":"length(44)","type":"string"},"contentLength":{"description":"a number between 1 and 2147483647","maximum":2147483647,"minimum":1,"title":"between(1, 2147483647)","type":"integer"},"contentType":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"}},"required":["contentType","contentLength"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"requiredHeaders":{"additionalProperties":false,"properties":{"content-length":{"description":"a string matching the pattern ^\\\\d+$","pattern":"^\\\\d+$","type":"string"},"content-type":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"},"x-amz-checksum-sha256":{"type":"string"}},"required":["content-type","content-length"],"type":"object"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadUrl":{"description":"a string at least 1 character(s) long","minLength":1,"title":"minLength(1)","type":"string"}},"required":["uploadIntentId","uploadUrl","expiresAt","requiredHeaders"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"complete-receipt-upload","title":"Complete receipt upload","description":"Finish a receipt upload and attach the uploaded file to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId","uploadIntentId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"createdAt":{"type":"string"},"hasReceipt":{"type":"boolean"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"payee":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"receiptCurrency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"receiptSubtotalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"receiptValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"rounding":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"enum":["PAID","PENDING"],"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","status","receiptSubtotalValue","receiptValue","receiptCurrency","taxPercentage","paymentDate","paymentValue","paymentCurrency","rounding","hasReceipt","payee","tags","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-receipt-download","title":"Get receipt download","description":"Issue a short-lived download grant for the receipt attached to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/receipt\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/receipt\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-invoice-pdf","title":"Get invoice PDF","description":"Issue a short-lived download grant for an invoice PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-quote-pdf","title":"Get quote PDF","description":"Issue a short-lived download grant for a quote PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"quoteId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["quoteId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}}],"resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":0}'
|
|
355
|
+
}
|
|
356
|
+
}
|
|
357
|
+
]
|
|
358
|
+
},
|
|
359
|
+
{
|
|
360
|
+
id: 'mcp.tools.list.afloat.synthetic',
|
|
361
|
+
caseId: 'mcp.tools.list',
|
|
362
|
+
evidence: 'unverified',
|
|
363
|
+
recordedAt: '2026-10-02',
|
|
364
|
+
account: 'synthetic',
|
|
365
|
+
endpoint: 'https://useafloat.com/mcp',
|
|
366
|
+
note: 'A listing on one tools/list page: the published tool subset, the receipt-upload tools marked readOnlyHint false. Derived from the provider source (owner-supplied), not a live recording: the envelopes are the pinned official MCP server SDK 2.0.0 run in-process with the provider handler options, the listing is the published tool subset, and the results follow the provider output builders over synthetic data.',
|
|
367
|
+
exchanges: [
|
|
368
|
+
{
|
|
369
|
+
request: {
|
|
370
|
+
method: 'POST',
|
|
371
|
+
url: 'https://useafloat.com/mcp',
|
|
372
|
+
headers: {
|
|
373
|
+
accept: 'application/json, text/event-stream',
|
|
374
|
+
'content-type': 'application/json',
|
|
375
|
+
'mcp-method': 'server/discover',
|
|
376
|
+
'mcp-protocol-version': '2026-07-28'
|
|
377
|
+
},
|
|
378
|
+
body: {
|
|
379
|
+
jsonrpc: '2.0',
|
|
380
|
+
id: 'server-discover-probe-1',
|
|
381
|
+
method: 'server/discover',
|
|
382
|
+
params: {
|
|
383
|
+
_meta: {
|
|
384
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
385
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
386
|
+
name: 'yolk',
|
|
387
|
+
version: '0.1.0'
|
|
388
|
+
},
|
|
389
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
390
|
+
}
|
|
391
|
+
}
|
|
392
|
+
}
|
|
393
|
+
},
|
|
394
|
+
response: {
|
|
395
|
+
status: 200,
|
|
396
|
+
headers: {
|
|
397
|
+
'content-type': 'application/json'
|
|
398
|
+
},
|
|
399
|
+
body: '{"result":{"supportedVersions":["2026-07-28"],"capabilities":{"tools":{"listChanged":false}},"instructions":"Tools for reading and managing business records.","resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":"server-discover-probe-1"}'
|
|
400
|
+
}
|
|
401
|
+
},
|
|
402
|
+
{
|
|
403
|
+
request: {
|
|
404
|
+
method: 'POST',
|
|
405
|
+
url: 'https://useafloat.com/mcp',
|
|
406
|
+
headers: {
|
|
407
|
+
accept: 'application/json, text/event-stream',
|
|
408
|
+
'content-type': 'application/json',
|
|
409
|
+
'mcp-method': 'tools/list',
|
|
410
|
+
'mcp-protocol-version': '2026-07-28'
|
|
411
|
+
},
|
|
412
|
+
body: {
|
|
413
|
+
jsonrpc: '2.0',
|
|
414
|
+
id: 0,
|
|
415
|
+
method: 'tools/list',
|
|
416
|
+
params: {
|
|
417
|
+
_meta: {
|
|
418
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
419
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
420
|
+
name: 'yolk',
|
|
421
|
+
version: '0.1.0'
|
|
422
|
+
},
|
|
423
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
424
|
+
}
|
|
425
|
+
}
|
|
426
|
+
}
|
|
427
|
+
},
|
|
428
|
+
response: {
|
|
429
|
+
status: 200,
|
|
430
|
+
headers: {
|
|
431
|
+
'content-type': 'application/json'
|
|
432
|
+
},
|
|
433
|
+
body: '{"result":{"tools":[{"name":"list-invoices","title":"List invoices","description":"List issued invoices, one page at a time, optionally filtered by search text or payment status.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"page":{"description":"a positive number","exclusiveMinimum":0,"title":"positive","type":"integer"},"search":{"type":"string"},"size":{"enum":[10,25,50,100],"type":"number"},"status":{"enum":["all","paid","pending","overdue","voided"],"type":"string"}},"required":[],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"items":{"items":{"additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence":{"additionalProperties":false,"properties":{"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["prefix","suffix"],"type":"object"},"status":{"enum":["ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","purchaseOrder","notes","customer","sequence","updatedAt"],"type":"object"},"type":"array"},"totalCount":{"description":"an integer","title":"int","type":"integer"}},"required":["items","totalCount"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-invoice","title":"Get invoice","description":"Read one invoice by id, with its line items, customer, vendor, and numbering sequence.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"createdAt":{"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"items":{"items":{"additionalProperties":false,"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"quantity":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"title":{"type":"string"},"totalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"unitValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"}},"required":["id","title","description","quantity","unitValue","taxPercentage","totalValue"],"type":"object"},"type":"array"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"secondTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"sequence":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["id","name","prefix","suffix"],"type":"object"},"shippingTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"shippingValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"status":{"enum":["DRAFT","ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"},"vendor":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"paymentInfo":{"anyOf":[{"type":"string"},{"type":"null"}]},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact","paymentInfo"],"type":"object"},"voidedDate":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","secondTaxPercentage","shippingValue","shippingTaxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","voidedDate","purchaseOrder","notes","customer","vendor","sequence","items","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-tax-return-download","title":"Get tax return download","description":"Issue a short-lived download grant for a completed tax-return archive.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"taxReturnId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["taxReturnId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-logo-download","title":"Get logo download","description":"Issue a short-lived download grant for a logo.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"logoId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["logoId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/logo\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/logo\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"create-receipt-upload","title":"Create receipt upload","description":"Start a receipt upload: answers a short-lived upload URL and the headers the upload must send.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"checksumSha256":{"description":"a string matching the pattern ^[A-Za-z0-9+/]{43}=$","maxLength":44,"minLength":44,"pattern":"^[A-Za-z0-9+/]{43}=$","title":"length(44)","type":"string"},"contentLength":{"description":"a number between 1 and 2147483647","maximum":2147483647,"minimum":1,"title":"between(1, 2147483647)","type":"integer"},"contentType":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"}},"required":["contentType","contentLength"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"requiredHeaders":{"additionalProperties":false,"properties":{"content-length":{"description":"a string matching the pattern ^\\\\d+$","pattern":"^\\\\d+$","type":"string"},"content-type":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"},"x-amz-checksum-sha256":{"type":"string"}},"required":["content-type","content-length"],"type":"object"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadUrl":{"description":"a string at least 1 character(s) long","minLength":1,"title":"minLength(1)","type":"string"}},"required":["uploadIntentId","uploadUrl","expiresAt","requiredHeaders"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"complete-receipt-upload","title":"Complete receipt upload","description":"Finish a receipt upload and attach the uploaded file to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId","uploadIntentId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"createdAt":{"type":"string"},"hasReceipt":{"type":"boolean"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"payee":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"receiptCurrency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"receiptSubtotalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"receiptValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"rounding":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"enum":["PAID","PENDING"],"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","status","receiptSubtotalValue","receiptValue","receiptCurrency","taxPercentage","paymentDate","paymentValue","paymentCurrency","rounding","hasReceipt","payee","tags","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-receipt-download","title":"Get receipt download","description":"Issue a short-lived download grant for the receipt attached to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/receipt\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/receipt\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-invoice-pdf","title":"Get invoice PDF","description":"Issue a short-lived download grant for an invoice PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-quote-pdf","title":"Get quote PDF","description":"Issue a short-lived download grant for a quote PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"quoteId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["quoteId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}}],"resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":0}'
|
|
434
|
+
}
|
|
435
|
+
}
|
|
436
|
+
]
|
|
437
|
+
},
|
|
438
|
+
{
|
|
439
|
+
id: 'mcp.tools.call-read.afloat.synthetic',
|
|
440
|
+
caseId: 'mcp.tools.call-read',
|
|
441
|
+
evidence: 'unverified',
|
|
442
|
+
recordedAt: '2026-10-02',
|
|
443
|
+
account: 'synthetic',
|
|
444
|
+
endpoint: 'https://useafloat.com/mcp',
|
|
445
|
+
note: 'A listing (the readOnlyHint precondition), then list-invoices answered with structured content matching its output schema. Derived from the provider source (owner-supplied), not a live recording: the envelopes are the pinned official MCP server SDK 2.0.0 run in-process with the provider handler options, the listing is the published tool subset, and the results follow the provider output builders over synthetic data.',
|
|
446
|
+
exchanges: [
|
|
447
|
+
{
|
|
448
|
+
request: {
|
|
449
|
+
method: 'POST',
|
|
450
|
+
url: 'https://useafloat.com/mcp',
|
|
451
|
+
headers: {
|
|
452
|
+
accept: 'application/json, text/event-stream',
|
|
453
|
+
'content-type': 'application/json',
|
|
454
|
+
'mcp-method': 'server/discover',
|
|
455
|
+
'mcp-protocol-version': '2026-07-28'
|
|
456
|
+
},
|
|
457
|
+
body: {
|
|
458
|
+
jsonrpc: '2.0',
|
|
459
|
+
id: 'server-discover-probe-1',
|
|
460
|
+
method: 'server/discover',
|
|
461
|
+
params: {
|
|
462
|
+
_meta: {
|
|
463
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
464
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
465
|
+
name: 'yolk',
|
|
466
|
+
version: '0.1.0'
|
|
467
|
+
},
|
|
468
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
469
|
+
}
|
|
470
|
+
}
|
|
471
|
+
}
|
|
472
|
+
},
|
|
473
|
+
response: {
|
|
474
|
+
status: 200,
|
|
475
|
+
headers: {
|
|
476
|
+
'content-type': 'application/json'
|
|
477
|
+
},
|
|
478
|
+
body: '{"result":{"supportedVersions":["2026-07-28"],"capabilities":{"tools":{"listChanged":false}},"instructions":"Tools for reading and managing business records.","resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":"server-discover-probe-1"}'
|
|
479
|
+
}
|
|
480
|
+
},
|
|
481
|
+
{
|
|
482
|
+
request: {
|
|
483
|
+
method: 'POST',
|
|
484
|
+
url: 'https://useafloat.com/mcp',
|
|
485
|
+
headers: {
|
|
486
|
+
accept: 'application/json, text/event-stream',
|
|
487
|
+
'content-type': 'application/json',
|
|
488
|
+
'mcp-method': 'tools/list',
|
|
489
|
+
'mcp-protocol-version': '2026-07-28'
|
|
490
|
+
},
|
|
491
|
+
body: {
|
|
492
|
+
jsonrpc: '2.0',
|
|
493
|
+
id: 0,
|
|
494
|
+
method: 'tools/list',
|
|
495
|
+
params: {
|
|
496
|
+
_meta: {
|
|
497
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
498
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
499
|
+
name: 'yolk',
|
|
500
|
+
version: '0.1.0'
|
|
501
|
+
},
|
|
502
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
503
|
+
}
|
|
504
|
+
}
|
|
505
|
+
}
|
|
506
|
+
},
|
|
507
|
+
response: {
|
|
508
|
+
status: 200,
|
|
509
|
+
headers: {
|
|
510
|
+
'content-type': 'application/json'
|
|
511
|
+
},
|
|
512
|
+
body: '{"result":{"tools":[{"name":"list-invoices","title":"List invoices","description":"List issued invoices, one page at a time, optionally filtered by search text or payment status.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"page":{"description":"a positive number","exclusiveMinimum":0,"title":"positive","type":"integer"},"search":{"type":"string"},"size":{"enum":[10,25,50,100],"type":"number"},"status":{"enum":["all","paid","pending","overdue","voided"],"type":"string"}},"required":[],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"items":{"items":{"additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence":{"additionalProperties":false,"properties":{"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["prefix","suffix"],"type":"object"},"status":{"enum":["ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","purchaseOrder","notes","customer","sequence","updatedAt"],"type":"object"},"type":"array"},"totalCount":{"description":"an integer","title":"int","type":"integer"}},"required":["items","totalCount"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-invoice","title":"Get invoice","description":"Read one invoice by id, with its line items, customer, vendor, and numbering sequence.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"createdAt":{"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"items":{"items":{"additionalProperties":false,"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"quantity":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"title":{"type":"string"},"totalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"unitValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"}},"required":["id","title","description","quantity","unitValue","taxPercentage","totalValue"],"type":"object"},"type":"array"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"secondTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"sequence":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["id","name","prefix","suffix"],"type":"object"},"shippingTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"shippingValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"status":{"enum":["DRAFT","ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"},"vendor":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"paymentInfo":{"anyOf":[{"type":"string"},{"type":"null"}]},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact","paymentInfo"],"type":"object"},"voidedDate":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","secondTaxPercentage","shippingValue","shippingTaxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","voidedDate","purchaseOrder","notes","customer","vendor","sequence","items","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-tax-return-download","title":"Get tax return download","description":"Issue a short-lived download grant for a completed tax-return archive.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"taxReturnId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["taxReturnId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-logo-download","title":"Get logo download","description":"Issue a short-lived download grant for a logo.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"logoId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["logoId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/logo\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/logo\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"create-receipt-upload","title":"Create receipt upload","description":"Start a receipt upload: answers a short-lived upload URL and the headers the upload must send.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"checksumSha256":{"description":"a string matching the pattern ^[A-Za-z0-9+/]{43}=$","maxLength":44,"minLength":44,"pattern":"^[A-Za-z0-9+/]{43}=$","title":"length(44)","type":"string"},"contentLength":{"description":"a number between 1 and 2147483647","maximum":2147483647,"minimum":1,"title":"between(1, 2147483647)","type":"integer"},"contentType":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"}},"required":["contentType","contentLength"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"requiredHeaders":{"additionalProperties":false,"properties":{"content-length":{"description":"a string matching the pattern ^\\\\d+$","pattern":"^\\\\d+$","type":"string"},"content-type":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"},"x-amz-checksum-sha256":{"type":"string"}},"required":["content-type","content-length"],"type":"object"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadUrl":{"description":"a string at least 1 character(s) long","minLength":1,"title":"minLength(1)","type":"string"}},"required":["uploadIntentId","uploadUrl","expiresAt","requiredHeaders"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"complete-receipt-upload","title":"Complete receipt upload","description":"Finish a receipt upload and attach the uploaded file to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId","uploadIntentId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"createdAt":{"type":"string"},"hasReceipt":{"type":"boolean"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"payee":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"receiptCurrency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"receiptSubtotalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"receiptValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"rounding":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"enum":["PAID","PENDING"],"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","status","receiptSubtotalValue","receiptValue","receiptCurrency","taxPercentage","paymentDate","paymentValue","paymentCurrency","rounding","hasReceipt","payee","tags","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-receipt-download","title":"Get receipt download","description":"Issue a short-lived download grant for the receipt attached to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/receipt\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/receipt\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-invoice-pdf","title":"Get invoice PDF","description":"Issue a short-lived download grant for an invoice PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-quote-pdf","title":"Get quote PDF","description":"Issue a short-lived download grant for a quote PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"quoteId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["quoteId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}}],"resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":0}'
|
|
513
|
+
}
|
|
514
|
+
},
|
|
515
|
+
{
|
|
516
|
+
request: {
|
|
517
|
+
method: 'POST',
|
|
518
|
+
url: 'https://useafloat.com/mcp',
|
|
519
|
+
headers: {
|
|
520
|
+
accept: 'application/json, text/event-stream',
|
|
521
|
+
'content-type': 'application/json',
|
|
522
|
+
'mcp-method': 'server/discover',
|
|
523
|
+
'mcp-protocol-version': '2026-07-28'
|
|
524
|
+
},
|
|
525
|
+
body: {
|
|
526
|
+
jsonrpc: '2.0',
|
|
527
|
+
id: 'server-discover-probe-1',
|
|
528
|
+
method: 'server/discover',
|
|
529
|
+
params: {
|
|
530
|
+
_meta: {
|
|
531
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
532
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
533
|
+
name: 'yolk',
|
|
534
|
+
version: '0.1.0'
|
|
535
|
+
},
|
|
536
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
537
|
+
}
|
|
538
|
+
}
|
|
539
|
+
}
|
|
540
|
+
},
|
|
541
|
+
response: {
|
|
542
|
+
status: 200,
|
|
543
|
+
headers: {
|
|
544
|
+
'content-type': 'application/json'
|
|
545
|
+
},
|
|
546
|
+
body: '{"result":{"supportedVersions":["2026-07-28"],"capabilities":{"tools":{"listChanged":false}},"instructions":"Tools for reading and managing business records.","resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":"server-discover-probe-1"}'
|
|
547
|
+
}
|
|
548
|
+
},
|
|
549
|
+
{
|
|
550
|
+
request: {
|
|
551
|
+
method: 'POST',
|
|
552
|
+
url: 'https://useafloat.com/mcp',
|
|
553
|
+
headers: {
|
|
554
|
+
accept: 'application/json, text/event-stream',
|
|
555
|
+
'content-type': 'application/json',
|
|
556
|
+
'mcp-method': 'tools/list',
|
|
557
|
+
'mcp-protocol-version': '2026-07-28'
|
|
558
|
+
},
|
|
559
|
+
body: {
|
|
560
|
+
jsonrpc: '2.0',
|
|
561
|
+
id: 0,
|
|
562
|
+
method: 'tools/list',
|
|
563
|
+
params: {
|
|
564
|
+
_meta: {
|
|
565
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
566
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
567
|
+
name: 'yolk',
|
|
568
|
+
version: '0.1.0'
|
|
569
|
+
},
|
|
570
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
571
|
+
}
|
|
572
|
+
}
|
|
573
|
+
}
|
|
574
|
+
},
|
|
575
|
+
response: {
|
|
576
|
+
status: 200,
|
|
577
|
+
headers: {
|
|
578
|
+
'content-type': 'application/json'
|
|
579
|
+
},
|
|
580
|
+
body: '{"result":{"tools":[{"name":"list-invoices","title":"List invoices","description":"List issued invoices, one page at a time, optionally filtered by search text or payment status.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"page":{"description":"a positive number","exclusiveMinimum":0,"title":"positive","type":"integer"},"search":{"type":"string"},"size":{"enum":[10,25,50,100],"type":"number"},"status":{"enum":["all","paid","pending","overdue","voided"],"type":"string"}},"required":[],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"items":{"items":{"additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence":{"additionalProperties":false,"properties":{"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["prefix","suffix"],"type":"object"},"status":{"enum":["ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","purchaseOrder","notes","customer","sequence","updatedAt"],"type":"object"},"type":"array"},"totalCount":{"description":"an integer","title":"int","type":"integer"}},"required":["items","totalCount"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-invoice","title":"Get invoice","description":"Read one invoice by id, with its line items, customer, vendor, and numbering sequence.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"createdAt":{"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"items":{"items":{"additionalProperties":false,"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"quantity":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"title":{"type":"string"},"totalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"unitValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"}},"required":["id","title","description","quantity","unitValue","taxPercentage","totalValue"],"type":"object"},"type":"array"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"secondTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"sequence":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["id","name","prefix","suffix"],"type":"object"},"shippingTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"shippingValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"status":{"enum":["DRAFT","ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"},"vendor":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"paymentInfo":{"anyOf":[{"type":"string"},{"type":"null"}]},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact","paymentInfo"],"type":"object"},"voidedDate":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","secondTaxPercentage","shippingValue","shippingTaxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","voidedDate","purchaseOrder","notes","customer","vendor","sequence","items","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-tax-return-download","title":"Get tax return download","description":"Issue a short-lived download grant for a completed tax-return archive.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"taxReturnId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["taxReturnId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-logo-download","title":"Get logo download","description":"Issue a short-lived download grant for a logo.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"logoId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["logoId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/logo\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/logo\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"create-receipt-upload","title":"Create receipt upload","description":"Start a receipt upload: answers a short-lived upload URL and the headers the upload must send.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"checksumSha256":{"description":"a string matching the pattern ^[A-Za-z0-9+/]{43}=$","maxLength":44,"minLength":44,"pattern":"^[A-Za-z0-9+/]{43}=$","title":"length(44)","type":"string"},"contentLength":{"description":"a number between 1 and 2147483647","maximum":2147483647,"minimum":1,"title":"between(1, 2147483647)","type":"integer"},"contentType":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"}},"required":["contentType","contentLength"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"requiredHeaders":{"additionalProperties":false,"properties":{"content-length":{"description":"a string matching the pattern ^\\\\d+$","pattern":"^\\\\d+$","type":"string"},"content-type":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"},"x-amz-checksum-sha256":{"type":"string"}},"required":["content-type","content-length"],"type":"object"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadUrl":{"description":"a string at least 1 character(s) long","minLength":1,"title":"minLength(1)","type":"string"}},"required":["uploadIntentId","uploadUrl","expiresAt","requiredHeaders"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"complete-receipt-upload","title":"Complete receipt upload","description":"Finish a receipt upload and attach the uploaded file to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId","uploadIntentId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"createdAt":{"type":"string"},"hasReceipt":{"type":"boolean"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"payee":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"receiptCurrency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"receiptSubtotalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"receiptValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"rounding":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"enum":["PAID","PENDING"],"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","status","receiptSubtotalValue","receiptValue","receiptCurrency","taxPercentage","paymentDate","paymentValue","paymentCurrency","rounding","hasReceipt","payee","tags","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-receipt-download","title":"Get receipt download","description":"Issue a short-lived download grant for the receipt attached to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/receipt\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/receipt\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-invoice-pdf","title":"Get invoice PDF","description":"Issue a short-lived download grant for an invoice PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-quote-pdf","title":"Get quote PDF","description":"Issue a short-lived download grant for a quote PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"quoteId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["quoteId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}}],"resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":0}'
|
|
581
|
+
}
|
|
582
|
+
},
|
|
583
|
+
{
|
|
584
|
+
request: {
|
|
585
|
+
method: 'POST',
|
|
586
|
+
url: 'https://useafloat.com/mcp',
|
|
587
|
+
headers: {
|
|
588
|
+
accept: 'application/json, text/event-stream',
|
|
589
|
+
'content-type': 'application/json',
|
|
590
|
+
'mcp-method': 'tools/call',
|
|
591
|
+
'mcp-protocol-version': '2026-07-28',
|
|
592
|
+
'mcp-name': 'list-invoices'
|
|
593
|
+
},
|
|
594
|
+
body: {
|
|
595
|
+
jsonrpc: '2.0',
|
|
596
|
+
id: 1,
|
|
597
|
+
method: 'tools/call',
|
|
598
|
+
params: {
|
|
599
|
+
name: 'list-invoices',
|
|
600
|
+
arguments: {
|
|
601
|
+
size: 10
|
|
602
|
+
},
|
|
603
|
+
_meta: {
|
|
604
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
605
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
606
|
+
name: 'yolk',
|
|
607
|
+
version: '0.1.0'
|
|
608
|
+
},
|
|
609
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
610
|
+
}
|
|
611
|
+
}
|
|
612
|
+
}
|
|
613
|
+
},
|
|
614
|
+
response: {
|
|
615
|
+
status: 200,
|
|
616
|
+
headers: {
|
|
617
|
+
'content-type': 'application/json'
|
|
618
|
+
},
|
|
619
|
+
body: '{"result":{"content":[{"type":"text","text":"{\\"items\\":[{\\"id\\":\\"yolksyntheticinvoice0001\\",\\"invoiceNumber\\":1,\\"status\\":\\"ISSUED\\",\\"computedStatus\\":\\"PAID\\",\\"invoiceDate\\":\\"2026-01-15\\",\\"invoiceDueDays\\":30,\\"currency\\":\\"EUR\\",\\"taxPercentage\\":\\"21\\",\\"itemsValue\\":\\"100\\",\\"invoiceValue\\":\\"121\\",\\"paymentDate\\":\\"2026-01-31\\",\\"paymentValue\\":\\"121\\",\\"paymentCurrency\\":\\"EUR\\",\\"purchaseOrder\\":null,\\"notes\\":null,\\"customer\\":{\\"id\\":\\"yolksyntheticcustomer001\\",\\"name\\":\\"Synthetic Customer\\"},\\"sequence\\":{\\"prefix\\":\\"SYN-\\",\\"suffix\\":\\"\\"},\\"updatedAt\\":\\"2026-01-31T12:00:00.000Z\\"}],\\"totalCount\\":1}"}],"structuredContent":{"items":[{"id":"yolksyntheticinvoice0001","invoiceNumber":1,"status":"ISSUED","computedStatus":"PAID","invoiceDate":"2026-01-15","invoiceDueDays":30,"currency":"EUR","taxPercentage":"21","itemsValue":"100","invoiceValue":"121","paymentDate":"2026-01-31","paymentValue":"121","paymentCurrency":"EUR","purchaseOrder":null,"notes":null,"customer":{"id":"yolksyntheticcustomer001","name":"Synthetic Customer"},"sequence":{"prefix":"SYN-","suffix":""},"updatedAt":"2026-01-31T12:00:00.000Z"}],"totalCount":1},"resultType":"complete","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":1}'
|
|
620
|
+
}
|
|
621
|
+
}
|
|
622
|
+
]
|
|
623
|
+
},
|
|
624
|
+
{
|
|
625
|
+
id: 'mcp.tools.call-tool-error.afloat.synthetic',
|
|
626
|
+
caseId: 'mcp.tools.call-tool-error',
|
|
627
|
+
evidence: 'unverified',
|
|
628
|
+
recordedAt: '2026-10-02',
|
|
629
|
+
account: 'synthetic',
|
|
630
|
+
endpoint: 'https://useafloat.com/mcp',
|
|
631
|
+
note: 'A listing (the readOnlyHint precondition), then list-invoices with a non-numeric size answered as a tool result with isError true and a VALIDATION_ERROR text. Derived from the provider source (owner-supplied), not a live recording: the envelopes are the pinned official MCP server SDK 2.0.0 run in-process with the provider handler options, the listing is the published tool subset, and the results follow the provider output builders over synthetic data.',
|
|
632
|
+
exchanges: [
|
|
633
|
+
{
|
|
634
|
+
request: {
|
|
635
|
+
method: 'POST',
|
|
636
|
+
url: 'https://useafloat.com/mcp',
|
|
637
|
+
headers: {
|
|
638
|
+
accept: 'application/json, text/event-stream',
|
|
639
|
+
'content-type': 'application/json',
|
|
640
|
+
'mcp-method': 'server/discover',
|
|
641
|
+
'mcp-protocol-version': '2026-07-28'
|
|
642
|
+
},
|
|
643
|
+
body: {
|
|
644
|
+
jsonrpc: '2.0',
|
|
645
|
+
id: 'server-discover-probe-1',
|
|
646
|
+
method: 'server/discover',
|
|
647
|
+
params: {
|
|
648
|
+
_meta: {
|
|
649
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
650
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
651
|
+
name: 'yolk',
|
|
652
|
+
version: '0.1.0'
|
|
653
|
+
},
|
|
654
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
655
|
+
}
|
|
656
|
+
}
|
|
657
|
+
}
|
|
658
|
+
},
|
|
659
|
+
response: {
|
|
660
|
+
status: 200,
|
|
661
|
+
headers: {
|
|
662
|
+
'content-type': 'application/json'
|
|
663
|
+
},
|
|
664
|
+
body: '{"result":{"supportedVersions":["2026-07-28"],"capabilities":{"tools":{"listChanged":false}},"instructions":"Tools for reading and managing business records.","resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":"server-discover-probe-1"}'
|
|
665
|
+
}
|
|
666
|
+
},
|
|
667
|
+
{
|
|
668
|
+
request: {
|
|
669
|
+
method: 'POST',
|
|
670
|
+
url: 'https://useafloat.com/mcp',
|
|
671
|
+
headers: {
|
|
672
|
+
accept: 'application/json, text/event-stream',
|
|
673
|
+
'content-type': 'application/json',
|
|
674
|
+
'mcp-method': 'tools/list',
|
|
675
|
+
'mcp-protocol-version': '2026-07-28'
|
|
676
|
+
},
|
|
677
|
+
body: {
|
|
678
|
+
jsonrpc: '2.0',
|
|
679
|
+
id: 0,
|
|
680
|
+
method: 'tools/list',
|
|
681
|
+
params: {
|
|
682
|
+
_meta: {
|
|
683
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
684
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
685
|
+
name: 'yolk',
|
|
686
|
+
version: '0.1.0'
|
|
687
|
+
},
|
|
688
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
689
|
+
}
|
|
690
|
+
}
|
|
691
|
+
}
|
|
692
|
+
},
|
|
693
|
+
response: {
|
|
694
|
+
status: 200,
|
|
695
|
+
headers: {
|
|
696
|
+
'content-type': 'application/json'
|
|
697
|
+
},
|
|
698
|
+
body: '{"result":{"tools":[{"name":"list-invoices","title":"List invoices","description":"List issued invoices, one page at a time, optionally filtered by search text or payment status.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"page":{"description":"a positive number","exclusiveMinimum":0,"title":"positive","type":"integer"},"search":{"type":"string"},"size":{"enum":[10,25,50,100],"type":"number"},"status":{"enum":["all","paid","pending","overdue","voided"],"type":"string"}},"required":[],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"items":{"items":{"additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence":{"additionalProperties":false,"properties":{"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["prefix","suffix"],"type":"object"},"status":{"enum":["ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","purchaseOrder","notes","customer","sequence","updatedAt"],"type":"object"},"type":"array"},"totalCount":{"description":"an integer","title":"int","type":"integer"}},"required":["items","totalCount"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-invoice","title":"Get invoice","description":"Read one invoice by id, with its line items, customer, vendor, and numbering sequence.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"createdAt":{"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"items":{"items":{"additionalProperties":false,"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"quantity":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"title":{"type":"string"},"totalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"unitValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"}},"required":["id","title","description","quantity","unitValue","taxPercentage","totalValue"],"type":"object"},"type":"array"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"secondTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"sequence":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["id","name","prefix","suffix"],"type":"object"},"shippingTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"shippingValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"status":{"enum":["DRAFT","ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"},"vendor":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"paymentInfo":{"anyOf":[{"type":"string"},{"type":"null"}]},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact","paymentInfo"],"type":"object"},"voidedDate":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","secondTaxPercentage","shippingValue","shippingTaxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","voidedDate","purchaseOrder","notes","customer","vendor","sequence","items","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-tax-return-download","title":"Get tax return download","description":"Issue a short-lived download grant for a completed tax-return archive.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"taxReturnId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["taxReturnId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-logo-download","title":"Get logo download","description":"Issue a short-lived download grant for a logo.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"logoId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["logoId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/logo\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/logo\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"create-receipt-upload","title":"Create receipt upload","description":"Start a receipt upload: answers a short-lived upload URL and the headers the upload must send.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"checksumSha256":{"description":"a string matching the pattern ^[A-Za-z0-9+/]{43}=$","maxLength":44,"minLength":44,"pattern":"^[A-Za-z0-9+/]{43}=$","title":"length(44)","type":"string"},"contentLength":{"description":"a number between 1 and 2147483647","maximum":2147483647,"minimum":1,"title":"between(1, 2147483647)","type":"integer"},"contentType":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"}},"required":["contentType","contentLength"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"requiredHeaders":{"additionalProperties":false,"properties":{"content-length":{"description":"a string matching the pattern ^\\\\d+$","pattern":"^\\\\d+$","type":"string"},"content-type":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"},"x-amz-checksum-sha256":{"type":"string"}},"required":["content-type","content-length"],"type":"object"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadUrl":{"description":"a string at least 1 character(s) long","minLength":1,"title":"minLength(1)","type":"string"}},"required":["uploadIntentId","uploadUrl","expiresAt","requiredHeaders"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"complete-receipt-upload","title":"Complete receipt upload","description":"Finish a receipt upload and attach the uploaded file to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId","uploadIntentId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"createdAt":{"type":"string"},"hasReceipt":{"type":"boolean"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"payee":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"receiptCurrency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"receiptSubtotalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"receiptValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"rounding":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"enum":["PAID","PENDING"],"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","status","receiptSubtotalValue","receiptValue","receiptCurrency","taxPercentage","paymentDate","paymentValue","paymentCurrency","rounding","hasReceipt","payee","tags","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-receipt-download","title":"Get receipt download","description":"Issue a short-lived download grant for the receipt attached to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/receipt\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/receipt\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-invoice-pdf","title":"Get invoice PDF","description":"Issue a short-lived download grant for an invoice PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-quote-pdf","title":"Get quote PDF","description":"Issue a short-lived download grant for a quote PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"quoteId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["quoteId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}}],"resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":0}'
|
|
699
|
+
}
|
|
700
|
+
},
|
|
701
|
+
{
|
|
702
|
+
request: {
|
|
703
|
+
method: 'POST',
|
|
704
|
+
url: 'https://useafloat.com/mcp',
|
|
705
|
+
headers: {
|
|
706
|
+
accept: 'application/json, text/event-stream',
|
|
707
|
+
'content-type': 'application/json',
|
|
708
|
+
'mcp-method': 'server/discover',
|
|
709
|
+
'mcp-protocol-version': '2026-07-28'
|
|
710
|
+
},
|
|
711
|
+
body: {
|
|
712
|
+
jsonrpc: '2.0',
|
|
713
|
+
id: 'server-discover-probe-1',
|
|
714
|
+
method: 'server/discover',
|
|
715
|
+
params: {
|
|
716
|
+
_meta: {
|
|
717
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
718
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
719
|
+
name: 'yolk',
|
|
720
|
+
version: '0.1.0'
|
|
721
|
+
},
|
|
722
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
723
|
+
}
|
|
724
|
+
}
|
|
725
|
+
}
|
|
726
|
+
},
|
|
727
|
+
response: {
|
|
728
|
+
status: 200,
|
|
729
|
+
headers: {
|
|
730
|
+
'content-type': 'application/json'
|
|
731
|
+
},
|
|
732
|
+
body: '{"result":{"supportedVersions":["2026-07-28"],"capabilities":{"tools":{"listChanged":false}},"instructions":"Tools for reading and managing business records.","resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":"server-discover-probe-1"}'
|
|
733
|
+
}
|
|
734
|
+
},
|
|
735
|
+
{
|
|
736
|
+
request: {
|
|
737
|
+
method: 'POST',
|
|
738
|
+
url: 'https://useafloat.com/mcp',
|
|
739
|
+
headers: {
|
|
740
|
+
accept: 'application/json, text/event-stream',
|
|
741
|
+
'content-type': 'application/json',
|
|
742
|
+
'mcp-method': 'tools/list',
|
|
743
|
+
'mcp-protocol-version': '2026-07-28'
|
|
744
|
+
},
|
|
745
|
+
body: {
|
|
746
|
+
jsonrpc: '2.0',
|
|
747
|
+
id: 0,
|
|
748
|
+
method: 'tools/list',
|
|
749
|
+
params: {
|
|
750
|
+
_meta: {
|
|
751
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
752
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
753
|
+
name: 'yolk',
|
|
754
|
+
version: '0.1.0'
|
|
755
|
+
},
|
|
756
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
757
|
+
}
|
|
758
|
+
}
|
|
759
|
+
}
|
|
760
|
+
},
|
|
761
|
+
response: {
|
|
762
|
+
status: 200,
|
|
763
|
+
headers: {
|
|
764
|
+
'content-type': 'application/json'
|
|
765
|
+
},
|
|
766
|
+
body: '{"result":{"tools":[{"name":"list-invoices","title":"List invoices","description":"List issued invoices, one page at a time, optionally filtered by search text or payment status.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"page":{"description":"a positive number","exclusiveMinimum":0,"title":"positive","type":"integer"},"search":{"type":"string"},"size":{"enum":[10,25,50,100],"type":"number"},"status":{"enum":["all","paid","pending","overdue","voided"],"type":"string"}},"required":[],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"items":{"items":{"additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence":{"additionalProperties":false,"properties":{"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["prefix","suffix"],"type":"object"},"status":{"enum":["ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","purchaseOrder","notes","customer","sequence","updatedAt"],"type":"object"},"type":"array"},"totalCount":{"description":"an integer","title":"int","type":"integer"}},"required":["items","totalCount"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-invoice","title":"Get invoice","description":"Read one invoice by id, with its line items, customer, vendor, and numbering sequence.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"createdAt":{"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"items":{"items":{"additionalProperties":false,"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"quantity":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"title":{"type":"string"},"totalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"unitValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"}},"required":["id","title","description","quantity","unitValue","taxPercentage","totalValue"],"type":"object"},"type":"array"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"secondTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"sequence":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["id","name","prefix","suffix"],"type":"object"},"shippingTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"shippingValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"status":{"enum":["DRAFT","ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"},"vendor":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"paymentInfo":{"anyOf":[{"type":"string"},{"type":"null"}]},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact","paymentInfo"],"type":"object"},"voidedDate":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","secondTaxPercentage","shippingValue","shippingTaxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","voidedDate","purchaseOrder","notes","customer","vendor","sequence","items","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-tax-return-download","title":"Get tax return download","description":"Issue a short-lived download grant for a completed tax-return archive.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"taxReturnId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["taxReturnId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-logo-download","title":"Get logo download","description":"Issue a short-lived download grant for a logo.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"logoId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["logoId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/logo\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/logo\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"create-receipt-upload","title":"Create receipt upload","description":"Start a receipt upload: answers a short-lived upload URL and the headers the upload must send.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"checksumSha256":{"description":"a string matching the pattern ^[A-Za-z0-9+/]{43}=$","maxLength":44,"minLength":44,"pattern":"^[A-Za-z0-9+/]{43}=$","title":"length(44)","type":"string"},"contentLength":{"description":"a number between 1 and 2147483647","maximum":2147483647,"minimum":1,"title":"between(1, 2147483647)","type":"integer"},"contentType":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"}},"required":["contentType","contentLength"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"requiredHeaders":{"additionalProperties":false,"properties":{"content-length":{"description":"a string matching the pattern ^\\\\d+$","pattern":"^\\\\d+$","type":"string"},"content-type":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"},"x-amz-checksum-sha256":{"type":"string"}},"required":["content-type","content-length"],"type":"object"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadUrl":{"description":"a string at least 1 character(s) long","minLength":1,"title":"minLength(1)","type":"string"}},"required":["uploadIntentId","uploadUrl","expiresAt","requiredHeaders"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"complete-receipt-upload","title":"Complete receipt upload","description":"Finish a receipt upload and attach the uploaded file to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId","uploadIntentId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"createdAt":{"type":"string"},"hasReceipt":{"type":"boolean"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"payee":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"receiptCurrency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"receiptSubtotalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"receiptValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"rounding":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"enum":["PAID","PENDING"],"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","status","receiptSubtotalValue","receiptValue","receiptCurrency","taxPercentage","paymentDate","paymentValue","paymentCurrency","rounding","hasReceipt","payee","tags","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-receipt-download","title":"Get receipt download","description":"Issue a short-lived download grant for the receipt attached to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/receipt\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/receipt\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-invoice-pdf","title":"Get invoice PDF","description":"Issue a short-lived download grant for an invoice PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-quote-pdf","title":"Get quote PDF","description":"Issue a short-lived download grant for a quote PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"quoteId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["quoteId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}}],"resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":0}'
|
|
767
|
+
}
|
|
768
|
+
},
|
|
769
|
+
{
|
|
770
|
+
request: {
|
|
771
|
+
method: 'POST',
|
|
772
|
+
url: 'https://useafloat.com/mcp',
|
|
773
|
+
headers: {
|
|
774
|
+
accept: 'application/json, text/event-stream',
|
|
775
|
+
'content-type': 'application/json',
|
|
776
|
+
'mcp-method': 'tools/call',
|
|
777
|
+
'mcp-protocol-version': '2026-07-28',
|
|
778
|
+
'mcp-name': 'list-invoices'
|
|
779
|
+
},
|
|
780
|
+
body: {
|
|
781
|
+
jsonrpc: '2.0',
|
|
782
|
+
id: 1,
|
|
783
|
+
method: 'tools/call',
|
|
784
|
+
params: {
|
|
785
|
+
name: 'list-invoices',
|
|
786
|
+
arguments: {
|
|
787
|
+
size: 'ten'
|
|
788
|
+
},
|
|
789
|
+
_meta: {
|
|
790
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
791
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
792
|
+
name: 'yolk',
|
|
793
|
+
version: '0.1.0'
|
|
794
|
+
},
|
|
795
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
796
|
+
}
|
|
797
|
+
}
|
|
798
|
+
}
|
|
799
|
+
},
|
|
800
|
+
response: {
|
|
801
|
+
status: 200,
|
|
802
|
+
headers: {
|
|
803
|
+
'content-type': 'application/json'
|
|
804
|
+
},
|
|
805
|
+
body: '{"result":{"content":[{"type":"text","text":"{\\"error\\":{\\"code\\":\\"VALIDATION_ERROR\\",\\"message\\":\\"The tool arguments did not match the expected schema.\\",\\"requestId\\":\\"00000000-0000-4000-8000-000000000001\\"}}"}],"isError":true,"resultType":"complete","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":1}'
|
|
806
|
+
}
|
|
807
|
+
}
|
|
808
|
+
]
|
|
809
|
+
},
|
|
810
|
+
{
|
|
811
|
+
id: 'mcp.errors.unknown-tool.afloat.synthetic',
|
|
812
|
+
caseId: 'mcp.errors.unknown-tool',
|
|
813
|
+
evidence: 'unverified',
|
|
814
|
+
recordedAt: '2026-10-02',
|
|
815
|
+
account: 'synthetic',
|
|
816
|
+
endpoint: 'https://useafloat.com/mcp',
|
|
817
|
+
note: 'A listing without the absent tool, then tools/call of it answered HTTP 200 with a JSON-RPC -32602 error carrying the request id. Derived from the provider source (owner-supplied), not a live recording: the envelopes are the pinned official MCP server SDK 2.0.0 run in-process with the provider handler options, the listing is the published tool subset, and the results follow the provider output builders over synthetic data.',
|
|
818
|
+
exchanges: [
|
|
819
|
+
{
|
|
820
|
+
request: {
|
|
821
|
+
method: 'POST',
|
|
822
|
+
url: 'https://useafloat.com/mcp',
|
|
823
|
+
headers: {
|
|
824
|
+
accept: 'application/json, text/event-stream',
|
|
825
|
+
'content-type': 'application/json',
|
|
826
|
+
'mcp-method': 'server/discover',
|
|
827
|
+
'mcp-protocol-version': '2026-07-28'
|
|
828
|
+
},
|
|
829
|
+
body: {
|
|
830
|
+
jsonrpc: '2.0',
|
|
831
|
+
id: 'server-discover-probe-1',
|
|
832
|
+
method: 'server/discover',
|
|
833
|
+
params: {
|
|
834
|
+
_meta: {
|
|
835
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
836
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
837
|
+
name: 'yolk',
|
|
838
|
+
version: '0.1.0'
|
|
839
|
+
},
|
|
840
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
841
|
+
}
|
|
842
|
+
}
|
|
843
|
+
}
|
|
844
|
+
},
|
|
845
|
+
response: {
|
|
846
|
+
status: 200,
|
|
847
|
+
headers: {
|
|
848
|
+
'content-type': 'application/json'
|
|
849
|
+
},
|
|
850
|
+
body: '{"result":{"supportedVersions":["2026-07-28"],"capabilities":{"tools":{"listChanged":false}},"instructions":"Tools for reading and managing business records.","resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":"server-discover-probe-1"}'
|
|
851
|
+
}
|
|
852
|
+
},
|
|
853
|
+
{
|
|
854
|
+
request: {
|
|
855
|
+
method: 'POST',
|
|
856
|
+
url: 'https://useafloat.com/mcp',
|
|
857
|
+
headers: {
|
|
858
|
+
accept: 'application/json, text/event-stream',
|
|
859
|
+
'content-type': 'application/json',
|
|
860
|
+
'mcp-method': 'tools/list',
|
|
861
|
+
'mcp-protocol-version': '2026-07-28'
|
|
862
|
+
},
|
|
863
|
+
body: {
|
|
864
|
+
jsonrpc: '2.0',
|
|
865
|
+
id: 0,
|
|
866
|
+
method: 'tools/list',
|
|
867
|
+
params: {
|
|
868
|
+
_meta: {
|
|
869
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
870
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
871
|
+
name: 'yolk',
|
|
872
|
+
version: '0.1.0'
|
|
873
|
+
},
|
|
874
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
875
|
+
}
|
|
876
|
+
}
|
|
877
|
+
}
|
|
878
|
+
},
|
|
879
|
+
response: {
|
|
880
|
+
status: 200,
|
|
881
|
+
headers: {
|
|
882
|
+
'content-type': 'application/json'
|
|
883
|
+
},
|
|
884
|
+
body: '{"result":{"tools":[{"name":"list-invoices","title":"List invoices","description":"List issued invoices, one page at a time, optionally filtered by search text or payment status.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"page":{"description":"a positive number","exclusiveMinimum":0,"title":"positive","type":"integer"},"search":{"type":"string"},"size":{"enum":[10,25,50,100],"type":"number"},"status":{"enum":["all","paid","pending","overdue","voided"],"type":"string"}},"required":[],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"items":{"items":{"additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence":{"additionalProperties":false,"properties":{"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["prefix","suffix"],"type":"object"},"status":{"enum":["ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","purchaseOrder","notes","customer","sequence","updatedAt"],"type":"object"},"type":"array"},"totalCount":{"description":"an integer","title":"int","type":"integer"}},"required":["items","totalCount"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-invoice","title":"Get invoice","description":"Read one invoice by id, with its line items, customer, vendor, and numbering sequence.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"createdAt":{"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"items":{"items":{"additionalProperties":false,"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"quantity":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"title":{"type":"string"},"totalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"unitValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"}},"required":["id","title","description","quantity","unitValue","taxPercentage","totalValue"],"type":"object"},"type":"array"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"secondTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"sequence":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["id","name","prefix","suffix"],"type":"object"},"shippingTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"shippingValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"status":{"enum":["DRAFT","ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"},"vendor":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"paymentInfo":{"anyOf":[{"type":"string"},{"type":"null"}]},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact","paymentInfo"],"type":"object"},"voidedDate":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","secondTaxPercentage","shippingValue","shippingTaxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","voidedDate","purchaseOrder","notes","customer","vendor","sequence","items","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-tax-return-download","title":"Get tax return download","description":"Issue a short-lived download grant for a completed tax-return archive.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"taxReturnId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["taxReturnId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-logo-download","title":"Get logo download","description":"Issue a short-lived download grant for a logo.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"logoId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["logoId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/logo\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/logo\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"create-receipt-upload","title":"Create receipt upload","description":"Start a receipt upload: answers a short-lived upload URL and the headers the upload must send.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"checksumSha256":{"description":"a string matching the pattern ^[A-Za-z0-9+/]{43}=$","maxLength":44,"minLength":44,"pattern":"^[A-Za-z0-9+/]{43}=$","title":"length(44)","type":"string"},"contentLength":{"description":"a number between 1 and 2147483647","maximum":2147483647,"minimum":1,"title":"between(1, 2147483647)","type":"integer"},"contentType":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"}},"required":["contentType","contentLength"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"requiredHeaders":{"additionalProperties":false,"properties":{"content-length":{"description":"a string matching the pattern ^\\\\d+$","pattern":"^\\\\d+$","type":"string"},"content-type":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"},"x-amz-checksum-sha256":{"type":"string"}},"required":["content-type","content-length"],"type":"object"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadUrl":{"description":"a string at least 1 character(s) long","minLength":1,"title":"minLength(1)","type":"string"}},"required":["uploadIntentId","uploadUrl","expiresAt","requiredHeaders"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"complete-receipt-upload","title":"Complete receipt upload","description":"Finish a receipt upload and attach the uploaded file to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId","uploadIntentId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"createdAt":{"type":"string"},"hasReceipt":{"type":"boolean"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"payee":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"receiptCurrency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"receiptSubtotalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"receiptValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"rounding":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"enum":["PAID","PENDING"],"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","status","receiptSubtotalValue","receiptValue","receiptCurrency","taxPercentage","paymentDate","paymentValue","paymentCurrency","rounding","hasReceipt","payee","tags","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-receipt-download","title":"Get receipt download","description":"Issue a short-lived download grant for the receipt attached to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/receipt\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/receipt\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-invoice-pdf","title":"Get invoice PDF","description":"Issue a short-lived download grant for an invoice PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-quote-pdf","title":"Get quote PDF","description":"Issue a short-lived download grant for a quote PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"quoteId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["quoteId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}}],"resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":0}'
|
|
885
|
+
}
|
|
886
|
+
},
|
|
887
|
+
{
|
|
888
|
+
request: {
|
|
889
|
+
method: 'POST',
|
|
890
|
+
url: 'https://useafloat.com/mcp',
|
|
891
|
+
headers: {
|
|
892
|
+
accept: 'application/json, text/event-stream',
|
|
893
|
+
'content-type': 'application/json',
|
|
894
|
+
'mcp-method': 'server/discover',
|
|
895
|
+
'mcp-protocol-version': '2026-07-28'
|
|
896
|
+
},
|
|
897
|
+
body: {
|
|
898
|
+
jsonrpc: '2.0',
|
|
899
|
+
id: 'server-discover-probe-1',
|
|
900
|
+
method: 'server/discover',
|
|
901
|
+
params: {
|
|
902
|
+
_meta: {
|
|
903
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
904
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
905
|
+
name: 'yolk',
|
|
906
|
+
version: '0.1.0'
|
|
907
|
+
},
|
|
908
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
909
|
+
}
|
|
910
|
+
}
|
|
911
|
+
}
|
|
912
|
+
},
|
|
913
|
+
response: {
|
|
914
|
+
status: 200,
|
|
915
|
+
headers: {
|
|
916
|
+
'content-type': 'application/json'
|
|
917
|
+
},
|
|
918
|
+
body: '{"result":{"supportedVersions":["2026-07-28"],"capabilities":{"tools":{"listChanged":false}},"instructions":"Tools for reading and managing business records.","resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":"server-discover-probe-1"}'
|
|
919
|
+
}
|
|
920
|
+
},
|
|
921
|
+
{
|
|
922
|
+
request: {
|
|
923
|
+
method: 'POST',
|
|
924
|
+
url: 'https://useafloat.com/mcp',
|
|
925
|
+
headers: {
|
|
926
|
+
accept: 'application/json, text/event-stream',
|
|
927
|
+
'content-type': 'application/json',
|
|
928
|
+
'mcp-method': 'tools/list',
|
|
929
|
+
'mcp-protocol-version': '2026-07-28'
|
|
930
|
+
},
|
|
931
|
+
body: {
|
|
932
|
+
jsonrpc: '2.0',
|
|
933
|
+
id: 0,
|
|
934
|
+
method: 'tools/list',
|
|
935
|
+
params: {
|
|
936
|
+
_meta: {
|
|
937
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
938
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
939
|
+
name: 'yolk',
|
|
940
|
+
version: '0.1.0'
|
|
941
|
+
},
|
|
942
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
943
|
+
}
|
|
944
|
+
}
|
|
945
|
+
}
|
|
946
|
+
},
|
|
947
|
+
response: {
|
|
948
|
+
status: 200,
|
|
949
|
+
headers: {
|
|
950
|
+
'content-type': 'application/json'
|
|
951
|
+
},
|
|
952
|
+
body: '{"result":{"tools":[{"name":"list-invoices","title":"List invoices","description":"List issued invoices, one page at a time, optionally filtered by search text or payment status.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"page":{"description":"a positive number","exclusiveMinimum":0,"title":"positive","type":"integer"},"search":{"type":"string"},"size":{"enum":[10,25,50,100],"type":"number"},"status":{"enum":["all","paid","pending","overdue","voided"],"type":"string"}},"required":[],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"items":{"items":{"additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence":{"additionalProperties":false,"properties":{"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["prefix","suffix"],"type":"object"},"status":{"enum":["ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","purchaseOrder","notes","customer","sequence","updatedAt"],"type":"object"},"type":"array"},"totalCount":{"description":"an integer","title":"int","type":"integer"}},"required":["items","totalCount"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-invoice","title":"Get invoice","description":"Read one invoice by id, with its line items, customer, vendor, and numbering sequence.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"computedStatus":{"enum":["PAID","PENDING","OVERDUE","VOIDED"],"type":"string"},"createdAt":{"type":"string"},"currency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"customer":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact"],"type":"object"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"invoiceDate":{"type":"string"},"invoiceDueDays":{"description":"an integer","title":"int","type":"integer"},"invoiceNumber":{"anyOf":[{"description":"an integer","title":"int","type":"integer"},{"type":"null"}]},"invoiceValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"items":{"items":{"additionalProperties":false,"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"quantity":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"title":{"type":"string"},"totalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"unitValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"}},"required":["id","title","description","quantity","unitValue","taxPercentage","totalValue"],"type":"object"},"type":"array"},"itemsValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"purchaseOrder":{"anyOf":[{"type":"string"},{"type":"null"}]},"secondTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"sequence":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"suffix":{"type":"string"}},"required":["id","name","prefix","suffix"],"type":"object"},"shippingTaxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"shippingValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"status":{"enum":["DRAFT","ISSUED","VOIDED"],"type":"string"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"},"vendor":{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"},"paymentInfo":{"anyOf":[{"type":"string"},{"type":"null"}]},"taxNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","taxNumber","address","contact","paymentInfo"],"type":"object"},"voidedDate":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","invoiceNumber","status","computedStatus","invoiceDate","invoiceDueDays","currency","taxPercentage","secondTaxPercentage","shippingValue","shippingTaxPercentage","itemsValue","invoiceValue","paymentDate","paymentValue","paymentCurrency","voidedDate","purchaseOrder","notes","customer","vendor","sequence","items","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get-tax-return-download","title":"Get tax return download","description":"Issue a short-lived download grant for a completed tax-return archive.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"taxReturnId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["taxReturnId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-logo-download","title":"Get logo download","description":"Issue a short-lived download grant for a logo.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"logoId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["logoId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/logo\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/logo\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"create-receipt-upload","title":"Create receipt upload","description":"Start a receipt upload: answers a short-lived upload URL and the headers the upload must send.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"checksumSha256":{"description":"a string matching the pattern ^[A-Za-z0-9+/]{43}=$","maxLength":44,"minLength":44,"pattern":"^[A-Za-z0-9+/]{43}=$","title":"length(44)","type":"string"},"contentLength":{"description":"a number between 1 and 2147483647","maximum":2147483647,"minimum":1,"title":"between(1, 2147483647)","type":"integer"},"contentType":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"}},"required":["contentType","contentLength"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"requiredHeaders":{"additionalProperties":false,"properties":{"content-length":{"description":"a string matching the pattern ^\\\\d+$","pattern":"^\\\\d+$","type":"string"},"content-type":{"enum":["image/jpeg","image/png","image/webp","image/gif","application/pdf"],"type":"string"},"x-amz-checksum-sha256":{"type":"string"}},"required":["content-type","content-length"],"type":"object"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadUrl":{"description":"a string at least 1 character(s) long","minLength":1,"title":"minLength(1)","type":"string"}},"required":["uploadIntentId","uploadUrl","expiresAt","requiredHeaders"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"complete-receipt-upload","title":"Complete receipt upload","description":"Finish a receipt upload and attach the uploaded file to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"uploadIntentId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId","uploadIntentId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"createdAt":{"type":"string"},"hasReceipt":{"type":"boolean"},"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"payee":{"additionalProperties":false,"properties":{"id":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"},"name":{"type":"string"}},"required":["id","name"],"type":"object"},"paymentCurrency":{"anyOf":[{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},{"type":"null"}]},"paymentDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"paymentValue":{"anyOf":[{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},{"type":"null"}]},"receiptCurrency":{"description":"a string 3 character(s) long","maxLength":3,"minLength":3,"title":"length(3)","type":"string"},"receiptSubtotalValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"receiptValue":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"rounding":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"enum":["PAID","PENDING"],"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"taxPercentage":{"description":"a string matching the pattern ^-?\\\\d+(?:\\\\.\\\\d+)?$","pattern":"^-?\\\\d+(?:\\\\.\\\\d+)?$","type":"string"},"updatedAt":{"type":"string"}},"required":["id","status","receiptSubtotalValue","receiptValue","receiptCurrency","taxPercentage","paymentDate","paymentValue","paymentCurrency","rounding","hasReceipt","payee","tags","createdAt","updatedAt"],"type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-receipt-download","title":"Get receipt download","description":"Issue a short-lived download grant for the receipt attached to an expense.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expenseId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["expenseId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/receipt\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/receipt\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-invoice-pdf","title":"Get invoice PDF","description":"Issue a short-lived download grant for an invoice PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"invoiceId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["invoiceId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get-quote-pdf","title":"Get quote PDF","description":"Issue a short-lived download grant for a quote PDF.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"quoteId":{"description":"a string at most 128 character(s) long","maxLength":128,"minLength":1,"title":"maxLength(128)","type":"string"}},"required":["quoteId"],"type":"object"},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"expiresAt":{"type":"string"},"url":{"description":"a string matching the pattern ^\\\\/mcp\\\\/files\\\\/pdf\\\\/","pattern":"^\\\\/mcp\\\\/files\\\\/pdf\\\\/","type":"string"}},"required":["url","expiresAt"],"type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}}],"resultType":"complete","ttlMs":0,"cacheScope":"private","_meta":{"io.modelcontextprotocol/serverInfo":{"name":"afloat","version":"2.0.0"}}},"jsonrpc":"2.0","id":0}'
|
|
953
|
+
}
|
|
954
|
+
},
|
|
955
|
+
{
|
|
956
|
+
request: {
|
|
957
|
+
method: 'POST',
|
|
958
|
+
url: 'https://useafloat.com/mcp',
|
|
959
|
+
headers: {
|
|
960
|
+
accept: 'application/json, text/event-stream',
|
|
961
|
+
'content-type': 'application/json',
|
|
962
|
+
'mcp-method': 'tools/call',
|
|
963
|
+
'mcp-protocol-version': '2026-07-28',
|
|
964
|
+
'mcp-name': 'yolk_conformance_absent'
|
|
965
|
+
},
|
|
966
|
+
body: {
|
|
967
|
+
jsonrpc: '2.0',
|
|
968
|
+
id: 1,
|
|
969
|
+
method: 'tools/call',
|
|
970
|
+
params: {
|
|
971
|
+
name: 'yolk_conformance_absent',
|
|
972
|
+
arguments: {},
|
|
973
|
+
_meta: {
|
|
974
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
975
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
976
|
+
name: 'yolk',
|
|
977
|
+
version: '0.1.0'
|
|
978
|
+
},
|
|
979
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
980
|
+
}
|
|
981
|
+
}
|
|
982
|
+
}
|
|
983
|
+
},
|
|
984
|
+
response: {
|
|
985
|
+
status: 200,
|
|
986
|
+
headers: {
|
|
987
|
+
'content-type': 'application/json'
|
|
988
|
+
},
|
|
989
|
+
body: '{"jsonrpc":"2.0","id":1,"error":{"code":-32602,"message":"Requested tool was not found"}}'
|
|
990
|
+
}
|
|
991
|
+
}
|
|
992
|
+
]
|
|
993
|
+
},
|
|
994
|
+
{
|
|
995
|
+
id: 'mcp.auth.rejected.afloat.synthetic',
|
|
996
|
+
caseId: 'mcp.auth.rejected',
|
|
997
|
+
evidence: 'unverified',
|
|
998
|
+
recordedAt: '2026-10-02',
|
|
999
|
+
account: 'synthetic',
|
|
1000
|
+
endpoint: 'https://useafloat.com/mcp',
|
|
1001
|
+
note: 'The era probe sent with the reserved invalid Afloat credential (authorization is never recorded), answered 401 with a WWW-Authenticate challenge of the Bearer scheme alone. Derived from the provider source (owner-supplied), not a live recording: the envelopes are the pinned official MCP server SDK 2.0.0 run in-process with the provider handler options, the listing is the published tool subset, and the results follow the provider output builders over synthetic data.',
|
|
1002
|
+
exchanges: [
|
|
1003
|
+
{
|
|
1004
|
+
request: {
|
|
1005
|
+
method: 'POST',
|
|
1006
|
+
url: 'https://useafloat.com/mcp',
|
|
1007
|
+
headers: {
|
|
1008
|
+
accept: 'application/json, text/event-stream',
|
|
1009
|
+
'content-type': 'application/json',
|
|
1010
|
+
'mcp-method': 'server/discover',
|
|
1011
|
+
'mcp-protocol-version': '2026-07-28'
|
|
1012
|
+
},
|
|
1013
|
+
body: {
|
|
1014
|
+
jsonrpc: '2.0',
|
|
1015
|
+
id: 'server-discover-probe-1',
|
|
1016
|
+
method: 'server/discover',
|
|
1017
|
+
params: {
|
|
1018
|
+
_meta: {
|
|
1019
|
+
'io.modelcontextprotocol/protocolVersion': '2026-07-28',
|
|
1020
|
+
'io.modelcontextprotocol/clientInfo': {
|
|
1021
|
+
name: 'yolk',
|
|
1022
|
+
version: '0.1.0'
|
|
1023
|
+
},
|
|
1024
|
+
'io.modelcontextprotocol/clientCapabilities': {}
|
|
1025
|
+
}
|
|
1026
|
+
}
|
|
1027
|
+
}
|
|
1028
|
+
},
|
|
1029
|
+
response: {
|
|
1030
|
+
status: 401,
|
|
1031
|
+
headers: {
|
|
1032
|
+
'content-type': 'application/json',
|
|
1033
|
+
'www-authenticate': 'Bearer'
|
|
1034
|
+
},
|
|
1035
|
+
body: '{"error":{"code":"UNAUTHORIZED","message":"Authentication required.","requestId":"00000000-0000-4000-8000-000000000001"}}'
|
|
1036
|
+
}
|
|
1037
|
+
}
|
|
1038
|
+
]
|
|
1039
|
+
}
|
|
1040
|
+
]
|