Create ArcGIS Connection

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://apidocs.zerionsoftware.com/doc/iformbuilder-v80/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "iFormBuilder V80 MCP server": {
    "url": "https://apidocs.zerionsoftware.com/doc/iformbuilder-v80/mcp"
  }
}

Close
POST /integrations/arcgis/connection

Exchanges the authorization code for a refresh token and stores the connection for the caller's profile. The state must be the one initiate returned to this user on this server, and the redirect URI and portal are re-checked against the current allowlists. Connecting again replaces the profile's previous connection, and its old grant is revoked at the portal unless another profile still uses it. No token is returned.

Authorization

Internal API clients only, and the user must be a SERVER or COMPANY user.

Headers

  • Authorization string

    e.g. Bearer {access_token}

application/json

Body Required

  • code string Required
  • state string Required

Responses

  • 201 application/json

    Created

    Hide response attributes Show response attributes object
    • connected boolean Required
    • username string | null Required
    • portal_url string | null Required
    • healthy boolean Required

      the stored grant still reads the account's content

  • 400 application/json

    Bad Request - code missing, state invalid or expired, an allowlist entry was removed, or ArcGIS rejected the code.

    Hide response attribute Show response attribute object
    • error_message string Required

      human-readable reason for the failure

  • 403 application/json

    Forbidden - not an internal client, or a BASIC user.

    Hide response attribute Show response attribute object
    • error_message string Required

      human-readable reason for the failure

  • 502 application/json

    Bad Gateway - ArcGIS could not be reached or answered with an error.

    Hide response attribute Show response attribute object
    • error_message string Required

      human-readable reason for the failure

  • 503 application/json

    Service Unavailable - ArcGIS has no client id on this server.

    Hide response attribute Show response attribute object
    • error_message string Required

      human-readable reason for the failure

POST /integrations/arcgis/connection
curl \
 --request POST 'https://api.iformbuilder.com/exzact/api/v80/[servername]/integrations/arcgis/connection' \
 --header "Content-Type: application/json" \
 --header "Authorization: Bearer {access_token}" \
 --data '{
  "code": "string",
  "state": "string"
}'
Request examples
# Headers
Authorization: Bearer {access_token}

# Payload
{
  "code": "string",
  "state": "string"
}
Response examples (201)
{
  "connected": true,
  "username": "jdoe_example",
  "portal_url": "https://www.arcgis.com/sharing",
  "healthy": true
}
Response examples (400)
{
  "error_message": "string"
}
Response examples (403)
{
  "error_message": "string"
}
Response examples (502)
{
  "error_message": "string"
}
Response examples (503)
{
  "error_message": "string"
}