Integrates with Google's Developer Expert (GDE) program via the Advocu API, allowing GDEs to report various activities such as content creation, speaking engagements, workshops, mentoring sessions, product feedback, and interactions with Google employees.
Mentioned as a platform where content creation activities can be reported, allowing GDEs to submit their blog posts published on Medium.
Supports reporting activities related to React, such as blog posts about React hooks or presentations at React conferences.
Allows reporting of mentoring sessions and other activities related to TypeScript development.
Activity Reporting MCP Server
Motivation
This project empowers Google Developer Experts (GDEs) to effortlessly report their activities through AI-powered conversational interfaces. By integrating the Advocu API with the Model Context Protocol (MCP), GDEs can now submit their content creation, speaking engagements, workshops, mentoring sessions, and other activities directly through AI chat models or command-line tools. This streamlines the reporting process, making it more intuitive and accessible while maintaining the detailed tracking that the GDE program requires.
A Model Context Protocol (MCP) server for reporting activities to the Advocu GDE API.
Quick Installation
Using NPM
Using npx (Recommended: No Installation Required)
Configuration
Prerequisites
- Node.js 18+
- Advocu GDE API access token
Step 1: Configure Claude Desktop
Edit your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
Option A: Using Global Installation
Option B: Using npx
Step 2: Restart Claude Desktop
Close and reopen Claude Desktop to load the new configuration.
Alternative: Local Development Setup
If you want to contribute or modify the server:
Then configure Claude Desktop with the local path:
Available Tools
Once configured, you'll have access to these tools in Claude:
- submit_content_creation - Report content creation activities
- submit_public_speaking - Report public speaking engagements
- submit_workshop - Report workshop sessions
- submit_mentoring - Report mentoring activities
- submit_product_feedback - Report product feedback submissions
- submit_googler_interaction - Report interactions with Google employees
- submit_story - Report success stories
Usage Examples
In Claude, you can use commands like:
API Reference
For detailed information about all available endpoints, parameters, and data formats, see the API Documentation.
Development
Development mode
Build
Lint and format
Rate Limiting
The API has a limit of 30 requests per minute. The server automatically handles 429 errors.
Project Structure
Troubleshooting
Error: "Command not found"
- Verify that the path in
claude_desktop_config.json
is absolute - Ensure the file is executable:
chmod +x dist/index.js
Error: "Authentication failed"
- Verify that your token in
.env
is correct - The token must have permissions for the Personal API
Error: "ADVOCU_ACCESS_TOKEN is not set"
- Make sure your
.env
file exists in the project root - Verify the token is properly set in the
.env
file
Error: "Rate limit exceeded"
- Wait one minute before making more requests
- The API limits to 30 requests per minute
Contributing
- Fork the project
- Create a feature branch:
git checkout -b feature/new-feature
- Commit your changes:
git commit -am 'Add new feature'
- Push to the branch:
git push origin feature/new-feature
- Create a Pull Request
License
MIT License - see LICENSE file for details.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
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.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to interact with Gmail services, supporting email operations, draft management, and calendar functionality through Google API integration.Last updated -TypeScript
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants like Claude to interact with Google Cloud Platform environments through natural language, allowing users to query and manage GCP resources during conversations.Last updated -910262TypeScriptMIT License
- -securityFlicense-qualityA server implementing the Model Context Protocol that enables AI assistants like Claude to interact with Google's Gemini API for text generation, text analysis, and chat conversations.Last updated -Python
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants like Claude to read from, append to, and format text in Google Documents programmatically.Last updated -24TypeScriptMIT License