MCP Server

Peaqview MCP Documentation

Connect any MCP-compatible AI to your enterprise architecture repository. Query applications, analyze portfolios, extract contracts, and enforce technology governance through natural conversation. Works with Claude, Cursor, Windsurf, and any client that supports the Model Context Protocol.

105Tools Available
8Categories
HTTPSEncrypted

Quick Start

1

Prerequisites

  • Peaqview account with workspace access
  • Service account credentials from your admin

No installation required — Peaqview MCP works with any AI that supports the Model Context Protocol: claude.ai, Claude Desktop, Claude Code, Cursor, Windsurf, and more.

2

Connect to Peaqview

Add Peaqview as a remote MCP server in your AI client settings using your workspace URL:

https://your-instance.peaqview.com/mcp/

Compatible with any MCP client — no proxy or local setup needed.

3

Authenticate

Enter your service account credentials when prompted. Your AI client securely connects to your Peaqview workspace via OAuth.

4

Start Using

Open your AI client and try:

"Discover my architecture landscape and show portfolio health"

Configuration

Authentication

Peaqview uses OAuth-based authentication for MCP connections. Your admin creates a service account in the Administration panel, and your AI client handles the secure handshake automatically.

CredentialWhere to Get It
Service AccountCreated by your workspace admin under Administration > Connectors > MCP
Workspace URLYour Peaqview instance URL (e.g. https://your-instance.peaqview.com/mcp/)
Getting Started: Ask your Peaqview workspace administrator to create a service account for MCP access. No local installation or environment variables are required — everything runs through the remote MCP server.

Example Prompts

Try these prompts to explore Peaqview capabilities through your AI partner.

📄

Contract Extraction

"Read the contract PDF on my desktop and extract vendor, pricing, renewal date, and exit clauses. Save it to Peaqview and link it to the matching application."
📊

Portfolio Assessment

"Analyze our application portfolio: which apps have high run costs but low business criticality? Find rationalization candidates and estimate potential savings."
🏗️

Architecture Documentation

"Generate an architecture diagram showing all applications that depend on SAP ERP, including their interfaces and data flows."
🔍

Process Root Cause Analysis

"Our Order-to-Cash process has bottlenecks. Analyze the process mining data, identify slow activities, and find which applications are causing delays."
🛡️

Technology Governance

"I want to add MongoDB to our project. Check if it's approved in our Technology Radar. If it's on hold, what alternatives should I use?"

Impact Analysis

"We're planning to decommission our legacy CRM. What processes, interfaces, and downstream applications will be affected?"

Available Tools

105 tools organized by category. Click a category to explore.

propose_diagramAI-assisted architecture diagram builder with visual preview
propose_processBPMN process builder with swimlanes and gateways
adr_generatorGuided Architecture Decision Record creation flow
preview_reportInteractive report builder with chart customization
compare_applicationsRadar chart comparison across multiple dimensions
visualize_scenario_impactBefore/after scenario visualization with cost waterfall
debt_dashboardTechnical debt heatmap with category breakdown
cost_modelerWhat-if cost modeling with real-time financial projections
interface_mapperInteractive network graph for integration landscape
import_mapperCSV/Excel column-to-field mapper with AI suggestions
review_contract_dataReview and validate AI-extracted contract data
review_vendor_mappingConfirm vendor-to-application mappings
review_discoveryApprove items discovered from CMDB, APM, or cloud
build_relationshipInteractive relationship builder between objects

Security & Data Handling

🔒

Encrypted Transport

All data transmitted over HTTPS/TLS encryption

👤

User-Scoped Access

Tools only access data the authenticated user can see

📝

Full Audit Trail

All actions logged with complete traceability

🇪🇺

GDPR Compliant

Enterprise-grade data protection standards

Troubleshooting

Connection Failed

Symptom: "Failed to connect to Peaqview API"

Solution: Verify your CLIENT_ID and CLIENT_SECRET are correct. Check that your service account has access to the specified workspace.

Tools Not Appearing

Symptom: Your AI client doesn't show Peaqview tools

Solution: Verify the MCP server URL is correct and your client supports remote MCP servers. Try disconnecting and reconnecting. For Claude Desktop, check the MCP logs at ~/.config/Claude/logs/mcp*.log

Permission Denied

Symptom: "Insufficient permissions" error

Solution: Your service account may have read-only access. Contact your workspace admin to grant write permissions if needed.

Need Help?

Our team is here to help you get the most out of Peaqview MCP.

Contact Support