Start 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/initiate

Starts the API-brokered OAuth connection of the caller's profile to an ArcGIS account. Send the user to consent_url; ArcGIS redirects back to redirect_uri with code and state, which the consumer posts to POST /integrations/arcgis/connection.

  • redirect_uri must exactly match an entry of the arcGisRedirectUris server config (a JSON array or comma-separated list).
  • portal_url defaults to https://www.arcgis.com/sharing. Any https://*.arcgis.com/sharing portal is accepted. An ArcGIS Enterprise portal must be https, end in /sharing, and exactly match an entry of the arcGisPortalAllowlist server config.
  • consent_url carries the app's client id only, never a secret, and asks for a non-expiring refresh token.
  • state is signed and valid for 15 minutes.

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

  • redirect_uri string Required
  • portal_url string

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • state string
  • 400 application/json

    Bad Request - redirect_uri missing or not allowlisted, or portal_url not https, not ArcGIS Online and not allowlisted.

    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

  • 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/initiate
curl \
 --request POST 'https://api.iformbuilder.com/exzact/api/v80/[servername]/integrations/arcgis/connection/initiate' \
 --header "Content-Type: application/json" \
 --header "Authorization: Bearer {access_token}" \
 --data '{
  "redirect_uri": "https://app.example.com/integrations/arcgis/callback",
  "portal_url": "https://www.arcgis.com/sharing"
}'
Request examples
# Headers
Authorization: Bearer {access_token}

# Payload
{
  "redirect_uri": "https://app.example.com/integrations/arcgis/callback",
  "portal_url": "https://www.arcgis.com/sharing"
}
Response examples (200)
{
  "consent_url": "https://www.arcgis.com/sharing/oauth2/authorize?client_id=abc&response_type=code&redirect_uri=https%3A%2F%2Fapp.example.com%2Fintegrations%2Farcgis%2Fcallback&state=eyJ...&expiration=-1",
  "state": "string"
}
Response examples (400)
{
  "error_message": "string"
}
Response examples (403)
{
  "error_message": "string"
}
Response examples (503)
{
  "error_message": "string"
}