> ## Documentation Index > Fetch the complete documentation index at: https://docs.shareofmodel.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create a baseline report for analysis/search project > Creates a new baseline report entry and triggers background generation via Prefect. This endpoint returns immediately with the created record in `PENDING` status. The actual Google Slides report will be populated asynchronously. ## OpenAPI ````yaml https://openapi.shareofmodel.ai/swagger.json post /v1/organizations/{organization_id}/workspaces/{workspace_id}/reports openapi: 3.0.3 info: title: Share Of Model API version: v1 description: >- ## Model Context Protocol (MCP) In addition to this REST API, Share of Model exposes a **Model Context Protocol** server that lets AI assistants (Claude Desktop, Claude Code, MCP Inspector, custom agents…) call our endpoints directly as tools. Any MCP-compatible client can interact with Share of Model without writing custom integration code — connect once with your usual login and start asking the assistant to query the data for you. ### Connecting from Claude Desktop Open **Settings → Connectors**, scroll to the bottom and click **Add custom connector**, then paste `https://mcp.shareofmodel.ai/mcp/`. A browser window opens for you to log in with your Share of Model account (same login as the web app), and the assistant gains access to the tools. ### Connecting from Claude Code ```bash claude mcp add --transport http share-of-model https://mcp.shareofmodel.ai/mcp/ ``` The first time you call a tool, Claude Code opens your browser to complete the login. ### Connecting from MCP Inspector ```bash npx @modelcontextprotocol/inspector ``` In the Inspector UI, pick **Streamable HTTP** as transport, paste `https://mcp.shareofmodel.ai/mcp/`, and click **Connect**. The first connection prompts you to log in. ### Available tools Only endpoints tagged `mcp` in this OpenAPI spec are exposed as MCP tools, and only read-only (`GET`) routes are exposed. Everything tagged `mcp` below is callable from any compliant MCP client. ### Example prompts Once connected, try asking your assistant things like: - _"List the workspaces I have access to."_ - _"Show me the latest searches in workspace X."_ - _"Compare the share of model between brand A and brand B over the last 30 days."_ For more details on the protocol itself, see the [Model Context Protocol specification](https://modelcontextprotocol.io/). servers: - description: Production API url: https://api.shareofmodel.ai/ - description: Development API url: https://api.dev.shareofmodel.ai/ security: [] tags: - name: Auth description: Endpoints needed for API authentication. - name: Organizations description: Endpoints related to organizations, to list all available organizations. - name: Workspaces description: Endpoints related to workspaces, to list all available workspaces. - name: Analyses description: Endpoints related to analyses and analyses management. - name: Asset Evaluations description: Endpoints related to assets and asset evaluations. - name: Brand Catalog description: Endpoints related to general brand information. - name: Content Briefs description: Endpoints related to content briefs generation and optimisation. - name: Metrics description: >+ Endpoints related to brand metrics. **LEXICON** **Brand Awareness**: What opinion the LLMs have concerning specific brands, related to certain categories. **Brand Perception**: The general sentiment of the LLMs towards a brand, based on the pros and cons they mention. paths: /v1/organizations/{organization_id}/workspaces/{workspace_id}/reports: post: tags: - Analyses summary: Create a baseline report for analysis/search project description: >- Creates a new baseline report entry and triggers background generation via Prefect. This endpoint returns immediately with the created record in `PENDING` status. The actual Google Slides report will be populated asynchronously. operationId: create_baseline_report_for_analysis_or_project parameters: - in: path name: organization_id schema: type: string format: uuid description: A UUID string identifying the organization. required: true - in: path name: workspace_id schema: type: string format: uuid description: A UUID string identifying the workspace. required: true requestBody: content: application/json: schema: type: object additionalProperties: {} examples: BaselineReportPlaceholderReplacements: value: analysis: f41bcbf1-8f7a-46c1-baf3-18c9d1ff1234 search_project_id: null images_bytes: average_position_mention_rate_persona_1_image: 82828282 share_of_voice_model_image_persona_1: 82828282 perceived_strenghts_cluster_persona_1_image: 82828282 all_perceived_strenght_persona_1_image: 82828282 strenghts_by_llm_persona_1_image: 82828282 strenght_1_persona_1_image: 82828282 strenght_2_persona_1_image: 82828282 strenght_3_persona_1_image: 82828282 strenght_4_persona_1_image: 82828282 weakness_1_persona_1_image: 82828282 weakness_2_persona_1_image: 82828282 weakness_3_persona_1_image: 82828282 weakness_4_persona_1_image: 82828282 perceived_weaknesses_cluster_persona_1_image: 82828282 all_perceived_weakness_persona_1_image: 82828282 weaknesses_by_llm_persona_1_image: 82828282 attribute_evaluation_brand_persona_1_table: 82828282 attribute_evaluation_brand_persona_1_image: 82828282 sources_global_image: 82828282 summary: >- Example request payload for starting baseline report generation application/x-www-form-urlencoded: schema: type: object additionalProperties: {} examples: BaselineReportPlaceholderReplacements: value: analysis: f41bcbf1-8f7a-46c1-baf3-18c9d1ff1234 search_project_id: null images_bytes: average_position_mention_rate_persona_1_image: 82828282 share_of_voice_model_image_persona_1: 82828282 perceived_strenghts_cluster_persona_1_image: 82828282 all_perceived_strenght_persona_1_image: 82828282 strenghts_by_llm_persona_1_image: 82828282 strenght_1_persona_1_image: 82828282 strenght_2_persona_1_image: 82828282 strenght_3_persona_1_image: 82828282 strenght_4_persona_1_image: 82828282 weakness_1_persona_1_image: 82828282 weakness_2_persona_1_image: 82828282 weakness_3_persona_1_image: 82828282 weakness_4_persona_1_image: 82828282 perceived_weaknesses_cluster_persona_1_image: 82828282 all_perceived_weakness_persona_1_image: 82828282 weaknesses_by_llm_persona_1_image: 82828282 attribute_evaluation_brand_persona_1_table: 82828282 attribute_evaluation_brand_persona_1_image: 82828282 sources_global_image: 82828282 summary: >- Example request payload for starting baseline report generation multipart/form-data: schema: type: object additionalProperties: {} examples: BaselineReportPlaceholderReplacements: value: analysis: f41bcbf1-8f7a-46c1-baf3-18c9d1ff1234 search_project_id: null images_bytes: average_position_mention_rate_persona_1_image: 82828282 share_of_voice_model_image_persona_1: 82828282 perceived_strenghts_cluster_persona_1_image: 82828282 all_perceived_strenght_persona_1_image: 82828282 strenghts_by_llm_persona_1_image: 82828282 strenght_1_persona_1_image: 82828282 strenght_2_persona_1_image: 82828282 strenght_3_persona_1_image: 82828282 strenght_4_persona_1_image: 82828282 weakness_1_persona_1_image: 82828282 weakness_2_persona_1_image: 82828282 weakness_3_persona_1_image: 82828282 weakness_4_persona_1_image: 82828282 perceived_weaknesses_cluster_persona_1_image: 82828282 all_perceived_weakness_persona_1_image: 82828282 weaknesses_by_llm_persona_1_image: 82828282 attribute_evaluation_brand_persona_1_table: 82828282 attribute_evaluation_brand_persona_1_image: 82828282 sources_global_image: 82828282 summary: >- Example request payload for starting baseline report generation '*/*': schema: type: object additionalProperties: {} examples: BaselineReportPlaceholderReplacements: value: analysis: f41bcbf1-8f7a-46c1-baf3-18c9d1ff1234 search_project_id: null images_bytes: average_position_mention_rate_persona_1_image: 82828282 share_of_voice_model_image_persona_1: 82828282 perceived_strenghts_cluster_persona_1_image: 82828282 all_perceived_strenght_persona_1_image: 82828282 strenghts_by_llm_persona_1_image: 82828282 strenght_1_persona_1_image: 82828282 strenght_2_persona_1_image: 82828282 strenght_3_persona_1_image: 82828282 strenght_4_persona_1_image: 82828282 weakness_1_persona_1_image: 82828282 weakness_2_persona_1_image: 82828282 weakness_3_persona_1_image: 82828282 weakness_4_persona_1_image: 82828282 perceived_weaknesses_cluster_persona_1_image: 82828282 all_perceived_weakness_persona_1_image: 82828282 weaknesses_by_llm_persona_1_image: 82828282 attribute_evaluation_brand_persona_1_table: 82828282 attribute_evaluation_brand_persona_1_image: 82828282 sources_global_image: 82828282 summary: >- Example request payload for starting baseline report generation responses: '201': content: application/json: schema: type: object additionalProperties: {} examples: BaselineReportCreated: value: id: df2a3b6d-4f5c-47d2-92d4-8b17db3b9159 analysis: f41bcbf1-8f7a-46c1-baf3-18c9d1ff1234 search_project_id: null status: PENDING url: null created_by: e3c7a801-badf-45f2-9113-66a5e1239abc summary: Baseline report created description: >- Successfully created a baseline report entry and triggered background generation. security: - Bearer: [] components: securitySchemes: Bearer: type: apiKey in: header name: Authorization ````