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 URLhttps://www.silentvip.com/mcp
TransportStreamable 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 versions2025-06-18, 2025-03-26, 2024-11-05. A client asking for another version gets 2025-06-18.
Methodsinitialize, ping, tools/list, tools/call. A notification (a message without an id) answers 202 with no body.
AuthenticationAuthorization: Bearer <token>. Tokens start with svmcp_.
Limits600 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.

ToolWhat it returnsArguments
spend_byTravel 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, traveler
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.
policy_exceptionsOut-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_outstandingRefunds still owed to the company by suppliers, with how long each has been waiting.None
credits_expiringUnused ticket credits that expire within a number of days.days: Defaults to 60. From 1 to 730.
upcoming_tripsTrips starting within a number of days, with destination and travelers.days: Defaults to 30. From 1 to 365.
approvals_pendingApproval 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 statusWhenBody
401No token, a wrong one, or one that was revoked, expired or stoppedUnauthorized, with WWW-Authenticate: Bearer
405Any method but POSTPlain text
429More than 600 requests in the hourJSON-RPC error -32000
400A body over 64 KB, a batch, or a message that isn't JSON-RPC 2.0JSON-RPC error -32600
400A body that isn't JSONJSON-RPC error -32700
200An unknown methodJSON-RPC error -32601
200An unknown toolJSON-RPC error -32602
200A tool that couldn't runA 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 URLhttps://www.silentvip.com/scim/v2
AuthenticationAuthorization: Bearer <token>. Tokens start with svscim_. Every endpoint needs it, discovery included.
Content typeResponses are application/scim+json.
Resources/Users only. There are no groups, bulk operations, sorting, ETags or passwords.
DiscoveryGET /ServiceProviderConfig, GET /ResourceTypes, GET /Schemas
Limits2,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

RequestWhat it does
GET /UsersLists 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 /UsersAdds 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 attributeIn silentVIP
userName, or the primary emails valueThe login's work email, in lower case. Required.
name.givenName, name.familyNameThe traveler profile's first and last name
displayNameThe login's name
externalIdKept and returned, and can be filtered on
activeActive or disabled. Deactivating signs the person out everywhere, the app included, and moves approvals waiting for them on.
urn:silentvip:roletraveler (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 departmentThe traveler's department, matched by name to a department you already have in silentVIP
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User managerKept 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 statusscimTypeWhen
401No token, a wrong one, or an expired one
429More than 2,000 requests in the hour
400invalidSyntaxA 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
400invalidValueA userName that isn't an email, an email outside your verified domain, or a role change that would leave no active travel manager
400invalidFilterA filter other than those listed above
400invalidPath, mutability, noTargetA PATCH naming an unknown or read-only attribute, or a remove without a path
404A person who isn't in your account, or was deleted through SCIM
409uniquenessThe 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.

Try the demoBook a Demo