Developers
MCP and SCIM reference
Two programming interfaces your company can turn on in the silentVIP portal: a read-only MCP server that lets an AI assistant answer questions about your travel data, and SCIM 2.0 so your identity provider keeps your people up to date.
The samples use made-up people and ids. Put your own tokens in the shell variables SILENTVIP_MCP_TOKEN and SILENTVIP_SCIM_TOKEN, read from your secret store, and never put a token in source code. A token that may have leaked: revoke or replace it in the portal.
MCP
The read-only MCP server
Connect Claude or another AI assistant that speaks the Model Context Protocol to your company's own travel data. It can read; it can't book, change or approve anything.
| Server URL | https://www.silentvip.com/mcp |
| Transport | Streamable HTTP without sessions: one JSON-RPC 2.0 message per POST, answered with one JSON response. Batches aren't supported. A GET or any other method answers 405. |
| Protocol versions | 2025-06-18, 2025-03-26, 2024-11-05. A client asking for another version gets 2025-06-18. |
| Methods | initialize, ping, tools/list, tools/call. A notification (a message without an id) answers 202 with no body. |
| Authentication | Authorization: Bearer <token>. Tokens start with svmcp_. |
| Limits | 600 requests an hour per token. Request bodies up to 64 KB. |
Tokens
- A travel manager creates one under Organization, AI connections in the portal, with a label. The token is shown once; silentVIP keeps only a hash of it.
- Each token reads one company's data: the account it was made in. Results include your travelers' names.
- A token stops working when it's revoked on that page, when the travel manager who made it is disabled or is no longer a travel manager, or when your account is closed.
- Travel managers can make tokens expire 30, 90, 180 or 365 days after they're made, and stop when they aren't used for 30, 60 or 90 days, under Organization, Security. By default they work until revoked.
- Every tool call is recorded in your account's activity log. A token's last use is recorded at most once an hour.
Tools
Every tool is read-only (annotations.readOnlyHint is true) and returns at most 50 rows, or 100 for trips and approvals. Results come back twice: as structuredContent and as the same JSON in a text block. Amounts are per currency and never added across currencies.
| Tool | What it returns | Arguments |
|---|---|---|
spend_by | Travel spend for a period, net of refunds, grouped by one dimension. Amounts are per currency and never added across currencies. | dimension (required): one of entity, department, project, supplier, category, travelerperiod: One of this_month, last_month, this_quarter, last_quarter, year_to_date, last_12_months, or a month as YYYY-MM. Defaults to this_month. |
policy_exceptions | Out-of-policy bookings and approval requests in a period, with reasons and decisions. | period: One of this_month, last_month, this_quarter, last_quarter, year_to_date, last_12_months, or a month as YYYY-MM. Defaults to this_month. |
refunds_outstanding | Refunds still owed to the company by suppliers, with how long each has been waiting. | None |
credits_expiring | Unused ticket credits that expire within a number of days. | days: Defaults to 60. From 1 to 730. |
upcoming_trips | Trips starting within a number of days, with destination and travelers. | days: Defaults to 30. From 1 to 365. |
approvals_pending | Approval requests waiting for a decision, with who they wait on and for how long. | None |
Start a connection
curl -sS -X POST "https://www.silentvip.com/mcp" \
-H "Authorization: Bearer $SILENTVIP_MCP_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-06-18",
"capabilities": {},
"clientInfo": {
"name": "example-client",
"version": "1.0.0"
}
}
}'
Answer: 200
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"protocolVersion": "2025-06-18",
"capabilities": {
"tools": {
"listChanged": false
}
},
"serverInfo": {
"name": "silentvip-travel-data",
"version": "1.0.0"
},
"instructions": "Read-only access to one company's business travel data at silentVIP. Amounts are per currency; never add across currencies."
}
}
Call a tool: last month's spend by department
curl -sS -X POST "https://www.silentvip.com/mcp" \
-H "Authorization: Bearer $SILENTVIP_MCP_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "spend_by",
"arguments": {
"dimension": "department",
"period": "last_month"
}
}
}'
Answer: 200
{
"jsonrpc": "2.0",
"id": 2,
"result": {
"content": [
{
"type": "text",
"text": "(the same result as structuredContent, as JSON text)"
}
],
"structuredContent": {
"period": {
"from": "2026-10-01",
"to": "2026-10-31",
"label": "October 2026"
},
"dimension": "department",
"rows": [
{
"name": "Sales",
"bookings": 1,
"net": {
"amount": 1250,
"currency": "USD",
"formatted": "$1,250"
},
"fees": {
"amount": 25,
"currency": "USD",
"formatted": "$25"
}
}
]
},
"isError": false
}
}
Errors
| HTTP status | When | Body |
|---|---|---|
| 401 | No token, a wrong one, or one that was revoked, expired or stopped | Unauthorized, with WWW-Authenticate: Bearer |
| 405 | Any method but POST | Plain text |
| 429 | More than 600 requests in the hour | JSON-RPC error -32000 |
| 400 | A body over 64 KB, a batch, or a message that isn't JSON-RPC 2.0 | JSON-RPC error -32600 |
| 400 | A body that isn't JSON | JSON-RPC error -32700 |
| 200 | An unknown method | JSON-RPC error -32601 |
| 200 | An unknown tool | JSON-RPC error -32602 |
| 200 | A tool that couldn't run | A result with isError: true and a reference to quote to support |
SCIM
SCIM 2.0 user provisioning
Okta, Microsoft Entra ID or another SCIM 2.0 client can add, update and deactivate the people in your account: each one a silentVIP login with a traveler profile.
| Base URL | https://www.silentvip.com/scim/v2 |
| Authentication | Authorization: Bearer <token>. Tokens start with svscim_. Every endpoint needs it, discovery included. |
| Content type | Responses are application/scim+json. |
| Resources | /Users only. There are no groups, bulk operations, sorting, ETags or passwords. |
| Discovery | GET /ServiceProviderConfig, GET /ResourceTypes, GET /Schemas |
| Limits | 2,000 requests an hour per account. Lists return up to 200 people a page. |
The token
- A travel manager creates it under Organization, Security, where the base URL is shown too. It's shown once; silentVIP keeps only a hash of it. An account has one token: replacing it or revoking it stops the old one at once.
- Travel managers can make it expire 90, 180 or 365 days after it's made, on the same page. By default it works until it's replaced or revoked. An expired token answers 401, as a wrong one does.
- Emails must be at your account's verified domain, unless a travel manager allows other domains on that page.
Endpoints
| Request | What it does |
|---|---|
GET /Users | Lists your account's people, oldest first. startIndex (from 1) and count (default 100, at most 200) page through them. One filter at a time: userName eq "…", externalId eq "…", emails.value eq "…" or emails[type eq "work"].value eq "…". Any other filter answers 400 invalidFilter. |
POST /Users | Adds a person (201, with a Location header). A person deleted through SCIM comes back, as the same login, when they're added again with the same email. |
GET /Users/{id} | One person. |
PUT /Users/{id} | Replaces a person. userName is required. Optional attributes it leaves out (externalId, displayName, the manager, and the department when the enterprise extension is sent) are cleared. Role and active are kept when left out. |
PATCH /Users/{id} | Changes a person with add, replace and remove operations. An unknown attribute path or another operation answers 400 and applies none of the operations. Attributes silentVIP doesn't store, such as title or phoneNumbers, and other schemas' extensions are accepted and ignored. |
DELETE /Users/{id} | Deactivates the person (204). Their trips and history stay; from then on SCIM answers 404 for them. |
Attributes
| SCIM attribute | In silentVIP |
|---|---|
userName, or the primary emails value | The login's work email, in lower case. Required. |
name.givenName, name.familyName | The traveler profile's first and last name |
displayName | The login's name |
externalId | Kept and returned, and can be filtered on |
active | Active or disabled. Deactivating signs the person out everywhere, the app included, and moves approvals waiting for them on. |
urn:silentvip:role | traveler (the default), assistant, approver, finance or manager (travel manager). roles[0].value is read too. |
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User department | The traveler's department, matched by name to a department you already have in silentVIP |
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User manager | Kept and returned. When a travel manager turns on Use the manager from your identity provider as approver, it sets the person's approver: manager.value names another active person in your account by their SCIM id, externalId or email. |
A role change that would leave your account with no active travel manager is refused (400). Deactivating your only active travel manager goes through, and the silentVIP team is told.
Add a person
curl -sS -X POST "https://www.silentvip.com/scim/v2/Users" \
-H "Authorization: Bearer $SILENTVIP_SCIM_TOKEN" \
-H "Content-Type: application/scim+json" \
-d '{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
],
"userName": "jordan.lee@example.com",
"externalId": "00u8example1",
"name": {
"givenName": "Jordan",
"familyName": "Lee"
},
"displayName": "Jordan Lee",
"emails": [
{
"value": "jordan.lee@example.com",
"type": "work",
"primary": true
}
],
"active": true,
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"department": "Sales"
},
"urn:silentvip:role": "traveler"
}'
Answer: 201
{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
],
"id": "usr_3c9e1a7f5b2d4e60",
"externalId": "00u8example1",
"userName": "jordan.lee@example.com",
"name": {
"givenName": "Jordan",
"familyName": "Lee",
"formatted": "Jordan Lee"
},
"displayName": "Jordan Lee",
"emails": [
{
"value": "jordan.lee@example.com",
"type": "work",
"primary": true
}
],
"active": true,
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"department": "Sales"
},
"urn:silentvip:role": "traveler",
"meta": {
"resourceType": "User",
"created": "2026-11-20T15:04:05.000Z",
"lastModified": "2026-11-20T15:04:05.000Z",
"location": "https://www.silentvip.com/scim/v2/Users/usr_3c9e1a7f5b2d4e60"
}
}
Find a person by user name
curl -sS -X GET "https://www.silentvip.com/scim/v2/Users?filter=userName%20eq%20%22jordan.lee%40example.com%22" \
-H "Authorization: Bearer $SILENTVIP_SCIM_TOKEN"
Answer: 200
{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:ListResponse"
],
"totalResults": 1,
"startIndex": 1,
"itemsPerPage": 1,
"Resources": [
{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
],
"id": "usr_3c9e1a7f5b2d4e60",
"externalId": "00u8example1",
"userName": "jordan.lee@example.com",
"name": {
"givenName": "Jordan",
"familyName": "Lee",
"formatted": "Jordan Lee"
},
"displayName": "Jordan Lee",
"emails": [
{
"value": "jordan.lee@example.com",
"type": "work",
"primary": true
}
],
"active": true,
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"department": "Sales"
},
"urn:silentvip:role": "traveler",
"meta": {
"resourceType": "User",
"created": "2026-11-20T15:04:05.000Z",
"lastModified": "2026-11-20T15:04:05.000Z",
"location": "https://www.silentvip.com/scim/v2/Users/usr_3c9e1a7f5b2d4e60"
}
}
]
}
Deactivate a person
curl -sS -X PATCH "https://www.silentvip.com/scim/v2/Users/usr_3c9e1a7f5b2d4e60" \
-H "Authorization: Bearer $SILENTVIP_SCIM_TOKEN" \
-H "Content-Type: application/scim+json" \
-d '{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:PatchOp"
],
"Operations": [
{
"op": "replace",
"path": "active",
"value": false
}
]
}'
Answer: 200
{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
],
"id": "usr_3c9e1a7f5b2d4e60",
"externalId": "00u8example1",
"userName": "jordan.lee@example.com",
"name": {
"givenName": "Jordan",
"familyName": "Lee",
"formatted": "Jordan Lee"
},
"displayName": "Jordan Lee",
"emails": [
{
"value": "jordan.lee@example.com",
"type": "work",
"primary": true
}
],
"active": false,
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"department": "Sales"
},
"urn:silentvip:role": "traveler",
"meta": {
"resourceType": "User",
"created": "2026-11-20T15:04:05.000Z",
"lastModified": "2026-11-20T15:04:05.000Z",
"location": "https://www.silentvip.com/scim/v2/Users/usr_3c9e1a7f5b2d4e60"
}
}
Errors
Errors are SCIM error responses: {"schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"], "status": "…", "scimType": "…", "detail": "…"}.
| HTTP status | scimType | When |
|---|---|---|
| 401 | No token, a wrong one, or an expired one | |
| 429 | More than 2,000 requests in the hour | |
| 400 | invalidSyntax | A body that isn't a JSON object, or a PATCH that isn't a PatchOp, or uses an operation other than add, replace or remove |
| 400 | invalidValue | A userName that isn't an email, an email outside your verified domain, or a role change that would leave no active travel manager |
| 400 | invalidFilter | A filter other than those listed above |
| 400 | invalidPath, mutability, noTarget | A PATCH naming an unknown or read-only attribute, or a remove without a path |
| 404 | A person who isn't in your account, or was deleted through SCIM | |
| 409 | uniqueness | The email is already in use |
Questions
Need something else?
For signed event notifications, see Webhooks. For anything about MCP or SCIM, email support@silentvip.com.