Activity Reporting

v0.1.3Analyticsstable

Enables Google Developer Experts to report various activities (content creation, speaking engagements, workshops, mentoring) through AI conversational interfaces by connecting Advocu API with Model Context Protocol.

gdeadvocumcpservermodel-context-protocol
Share:
30
Stars
0
Downloads
0
Weekly
0/5

What is Activity Reporting?

Activity Reporting is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables google developer experts to report various activities (content creation, speaking engagements, workshops, mentoring) through ai conversational interfaces by connecting advocu api with model co...

Enables Google Developer Experts to report various activities (content creation, speaking engagements, workshops, mentoring) through AI conversational interfaces by connecting Advocu API with Model Context Protocol.

This server falls under the Analytics category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables Google Developer Experts to report various activitie

Use Cases

Report developer activities for Google Developer Experts program via conversational AI.
Submit content creation, speaking, and mentoring activities to Advocu API.
Track and organize program engagement through natural language reporting.
carlosazaustre

Maintainer

LicenseMIT License
Languagetypescript
Versionv0.1.3
UpdatedJan 28, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y advocu-mcp-server

Manual Installation

npx -y advocu-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Activity Reporting

The Advocu MCP Server enables Google Developer Experts (GDEs) and Microsoft MVPs to report their developer activities — talks, blog posts, videos, workshops, mentoring sessions, and more — through a conversational AI interface by connecting to the Advocu and Microsoft MVP APIs. Instead of navigating complex web dashboards, program members can describe their activities in natural language and have Claude submit them on their behalf. The server supports both Google GDE (via Advocu API) and Microsoft MVP program reporting in a single integration.

Prerequisites

  • Node.js 18 or higher installed
  • An Advocu access token (ADVOCU_ACCESS_TOKEN) from the Advocu Developer Portal for GDE reporting
  • A Microsoft MVP bearer token (MVP_ACCESS_TOKEN) and profile ID (MVP_USER_PROFILE_ID) for MVP reporting
  • An absolute path to a local docs directory (DOCS_DIR) for documentation access
  • An MCP-compatible client such as Claude Desktop
1

Install the server globally

Install the advocu-mcp-server package globally via npm so it can be invoked by your MCP client.

npm install -g advocu-mcp-server
2

Obtain your Advocu access token

Log into the Advocu Developer Portal at advocu.com and navigate to API settings to generate your access token.

3

Obtain your Microsoft MVP token (if applicable)

Run the token capture utility to open your browser and capture the MVP bearer token from the DevTools Network tab.

# From the cloned repo directory
npm run capture-mvp-token
4

Create your docs directory

Create the local directory that will be referenced by DOCS_DIR for documentation access.

mkdir -p /Users/yourname/advocu-docs
5

Configure Claude Desktop

Add the server to your Claude Desktop configuration file with your API tokens and docs directory path.

{
  "mcpServers": {
    "advocu": {
      "command": "npx",
      "args": ["-y", "advocu-mcp-server"],
      "env": {
        "ADVOCU_ACCESS_TOKEN": "your_advocu_access_token",
        "MVP_ACCESS_TOKEN": "your_mvp_bearer_token",
        "MVP_USER_PROFILE_ID": "your_mvp_profile_id",
        "DOCS_DIR": "/Users/yourname/advocu-docs"
      }
    }
  }
}

Activity Reporting Examples

Client configuration

Claude Desktop configuration for the Advocu MCP server supporting both GDE and MVP activity reporting.

{
  "mcpServers": {
    "advocu": {
      "command": "npx",
      "args": ["-y", "advocu-mcp-server"],
      "env": {
        "ADVOCU_ACCESS_TOKEN": "your_advocu_gde_token",
        "MVP_ACCESS_TOKEN": "your_microsoft_mvp_token",
        "MVP_USER_PROFILE_ID": "your_mvp_profile_id",
        "DOCS_DIR": "/Users/yourname/advocu-docs"
      }
    }
  }
}

Prompts to try

Example prompts for submitting GDE and MVP activities through natural language.

- "Submit my YouTube talk to the GDE program: Title: Building with MCP, Published: 2025-11-10, URL: https://youtube.com/watch?v=example, Views: 3200"
- "Report a speaking engagement for my Microsoft MVP profile: I gave a talk at Node.js Berlin on October 15, 2025 with 120 attendees"
- "Submit a blog post activity to GDE: Title: Getting Started with Model Context Protocol, URL: https://myblog.com/mcp-guide, Published: December 1, 2025"
- "What documentation is available for the Advocu API?"
- "Report a mentoring session to GDE: I mentored 3 developers on React for 2 hours on 2025-11-20"

Troubleshooting Activity Reporting

GDE activity submissions return 401 Unauthorized

Your ADVOCU_ACCESS_TOKEN may have expired. Generate a new token from the Advocu Developer Portal at advocu.com and update it in your Claude Desktop config.

MVP token capture script opens a browser but no token appears

Open DevTools in the browser window (F12), go to the Network tab, filter by 'XHR', complete the MVP login flow, and look for requests to graph.microsoft.com. Copy the Bearer token value from the Authorization header of one of those requests.

DOCS_DIR-related tools fail with 'directory not found'

Ensure DOCS_DIR is set to an absolute path (starting with /) that actually exists on your filesystem. Create the directory if it does not exist with 'mkdir -p /your/docs/path'.

Frequently Asked Questions about Activity Reporting

What is Activity Reporting?

Activity Reporting is a Model Context Protocol (MCP) server that enables google developer experts to report various activities (content creation, speaking engagements, workshops, mentoring) through ai conversational interfaces by connecting advocu api with model context protocol. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Activity Reporting?

Install via npm with the command: npx -y advocu-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Activity Reporting?

Activity Reporting works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Activity Reporting free to use?

Yes, Activity Reporting is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Analytics MCP Servers

Explore all analytics servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "activity-reporting-mcp-server": { "command": "npx", "args": ["-y", "advocu-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Activity Reporting?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides