@jaypie/mcp 0.3.4 → 0.4.1

package/skills/tools-datadog.md

@@ -0,0 +1,190 @@
+---
+description: Datadog MCP tools for logs, monitors, metrics, synthetics, and RUM
+related: datadog, tools, debugging, logs
+---
+
+# Datadog MCP Tools
+
+Tools for querying Datadog observability data via the Jaypie MCP.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `datadog_logs` | Search individual log entries |
+| `datadog_log_analytics` | Aggregate logs with groupBy |
+| `datadog_monitors` | List and check monitor status |
+| `datadog_synthetics` | List synthetic tests and results |
+| `datadog_metrics` | Query timeseries metrics |
+| `datadog_rum` | Search Real User Monitoring events |
+
+## Environment Variables
+
+Configure defaults via environment:
+
+| Variable | Description |
+|----------|-------------|
+| `DATADOG_API_KEY` or `DD_API_KEY` | API key (required) |
+| `DATADOG_APP_KEY` or `DD_APP_KEY` | Application key (required) |
+| `DD_ENV` | Default environment filter |
+| `DD_SERVICE` | Default service filter |
+| `DD_SOURCE` | Default log source (default: lambda) |
+
+## Log Search
+
+Search individual log entries:
+
+```
+# Search error logs
+datadog_logs --query "status:error" --from "now-1h"
+
+# Search by service
+datadog_logs --query "service:my-api status:error" --from "now-15m"
+
+# Search by attribute
+datadog_logs --query "@http.status_code:500" --from "now-1h"
+
+# Wildcard search
+datadog_logs --query "*timeout*" --from "now-30m"
+
+# Limit results
+datadog_logs --query "status:error" --from "now-1h" --limit 100
+```
+
+## Log Analytics
+
+Aggregate logs for statistics:
+
+```
+# Count errors by service
+datadog_log_analytics --groupBy '["service"]' --query "status:error"
+
+# Count by status code
+datadog_log_analytics --groupBy '["@http.status_code"]' --query "*"
+
+# Multiple groupings
+datadog_log_analytics --groupBy '["service", "status"]' --query "*"
+
+# Average response time
+datadog_log_analytics --groupBy '["service"]' \
+  --aggregation "avg" \
+  --metric "@duration" \
+  --query "*"
+```
+
+## Monitors
+
+Check monitor status:
+
+```
+# List all monitors
+datadog_monitors
+
+# Filter alerting monitors
+datadog_monitors --status '["Alert", "Warn"]'
+
+# Filter by name
+datadog_monitors --name "my-api"
+
+# Filter by tags
+datadog_monitors --tags '["env:production"]'
+```
+
+## Synthetics
+
+List synthetic tests:
+
+```
+# List all tests
+datadog_synthetics
+
+# Filter by type
+datadog_synthetics --type "api"
+datadog_synthetics --type "browser"
+
+# Get results for specific test
+datadog_synthetics --testId "abc-123-def"
+```
+
+## Metrics
+
+Query timeseries metrics:
+
+```
+# CPU usage
+datadog_metrics --query "avg:system.cpu.user{*}" --from "1h"
+
+# Lambda invocations
+datadog_metrics --query "sum:aws.lambda.invocations{function:my-func}.as_count()" --from "1h"
+
+# Lambda duration
+datadog_metrics --query "max:aws.lambda.duration{env:production}" --from "30m"
+```
+
+## RUM Events
+
+Search Real User Monitoring events:
+
+```
+# Search all events
+datadog_rum --from "now-1h"
+
+# Filter by type
+datadog_rum --query "@type:error" --from "now-1h"
+
+# Filter by session
+datadog_rum --query "@session.id:abc123" --from "now-1h"
+
+# Filter by URL
+datadog_rum --query "@view.url:*checkout*" --from "now-1h"
+```
+
+## Query Syntax
+
+### Log Search Syntax
+
+```
+status:error                    # By status
+@http.status_code:500          # By attribute
+service:my-api                  # By service
+*timeout*                       # Wildcard
+```
+
+### Time Ranges
+
+```
+now-15m                         # Last 15 minutes
+now-1h                          # Last hour
+now-1d                          # Last day
+2024-01-15T10:00:00Z           # Specific time (ISO 8601)
+```
+
+## Common Patterns
+
+### Debug Lambda Issues
+
+```
+# Search recent errors
+datadog_logs --query "service:my-function status:error" --from "now-1h"
+
+# Check error counts by service
+datadog_log_analytics --groupBy '["service"]' --query "status:error" --from "now-1h"
+```
+
+### Monitor Status Check
+
+```
+# Check alerting monitors
+datadog_monitors --status '["Alert", "Warn"]'
+```
+
+### Frontend Issues
+
+```
+# Search RUM errors
+datadog_rum --query "@type:error" --from "now-1h"
+
+# Check synthetic test results
+datadog_synthetics --testId "my-checkout-test"
+```
+

package/skills/tools-dynamodb.md

@@ -0,0 +1,140 @@
+---
+description: DynamoDB MCP tools for table queries, scans, and item retrieval
+related: dynamodb, tools, tools-aws
+---
+
+# DynamoDB MCP Tools
+
+Tools for interacting with DynamoDB tables via the Jaypie MCP.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `aws_dynamodb_describe_table` | Get table schema, indexes, and metadata |
+| `aws_dynamodb_query` | Query by partition key (efficient) |
+| `aws_dynamodb_scan` | Full table scan (use sparingly) |
+| `aws_dynamodb_get_item` | Get single item by primary key |
+
+## Describe Table
+
+Get table metadata including key schema, indexes, and throughput:
+
+```
+aws_dynamodb_describe_table --tableName "MyTable"
+```
+
+Returns:
+- Key schema (partition key, sort key)
+- Global secondary indexes
+- Billing mode and provisioned throughput
+- Item count and size estimates
+
+## Query by Partition Key
+
+Query is the most efficient way to retrieve items:
+
+```
+# Simple partition key query
+aws_dynamodb_query --tableName "MyTable" \
+  --keyConditionExpression "pk = :pk" \
+  --expressionAttributeValues '{":pk":{"S":"USER#123"}}'
+
+# With sort key condition
+aws_dynamodb_query --tableName "MyTable" \
+  --keyConditionExpression "pk = :pk AND begins_with(sk, :prefix)" \
+  --expressionAttributeValues '{":pk":{"S":"USER#123"},":prefix":{"S":"ORDER#"}}'
+
+# Query GSI
+aws_dynamodb_query --tableName "MyTable" --indexName "gsi1" \
+  --keyConditionExpression "gsi1pk = :status" \
+  --expressionAttributeValues '{":status":{"S":"ORDER#pending"}}'
+```
+
+## Get Single Item
+
+Retrieve a specific item by its full primary key:
+
+```
+# Simple key
+aws_dynamodb_get_item --tableName "MyTable" \
+  --key '{"pk":{"S":"USER#123"}}'
+
+# Composite key (partition + sort)
+aws_dynamodb_get_item --tableName "MyTable" \
+  --key '{"pk":{"S":"USER#123"},"sk":{"S":"PROFILE"}}'
+```
+
+## Scan Table
+
+Full table scan - use sparingly on large tables:
+
+```
+# Scan all items
+aws_dynamodb_scan --tableName "MyTable"
+
+# With filter (applied after scan, not efficient for filtering)
+aws_dynamodb_scan --tableName "MyTable" \
+  --filterExpression "status = :status" \
+  --expressionAttributeValues '{":status":{"S":"active"}}'
+
+# Limit results
+aws_dynamodb_scan --tableName "MyTable" --limit 10
+```
+
+## DynamoDB Attribute Format
+
+All values use DynamoDB's attribute value format:
+
+| Type | Format | Example |
+|------|--------|---------|
+| String | `{"S": "value"}` | `{"S": "USER#123"}` |
+| Number | `{"N": "123"}` | `{"N": "99.99"}` |
+| Boolean | `{"BOOL": true}` | `{"BOOL": false}` |
+| List | `{"L": [...]}` | `{"L": [{"S": "a"}, {"S": "b"}]}` |
+| Map | `{"M": {...}}` | `{"M": {"name": {"S": "John"}}}` |
+| Null | `{"NULL": true}` | `{"NULL": true}` |
+
+## Common Patterns
+
+### Get User Profile
+
+```
+aws_dynamodb_get_item --tableName "DataTable" \
+  --key '{"pk":{"S":"USER#123"},"sk":{"S":"PROFILE"}}'
+```
+
+### List User Orders
+
+```
+aws_dynamodb_query --tableName "DataTable" \
+  --keyConditionExpression "pk = :pk AND begins_with(sk, :prefix)" \
+  --expressionAttributeValues '{":pk":{"S":"USER#123"},":prefix":{"S":"ORDER#"}}'
+```
+
+### Find Pending Orders (via GSI)
+
+```
+aws_dynamodb_query --tableName "DataTable" --indexName "gsi1" \
+  --keyConditionExpression "gsi1pk = :status" \
+  --expressionAttributeValues '{":status":{"S":"ORDER#pending"}}'
+```
+
+### Check Table Schema
+
+```
+aws_dynamodb_describe_table --tableName "DataTable"
+```
+
+## Profile and Region
+
+All DynamoDB tools support profile and region flags:
+
+```
+aws_dynamodb_query --tableName "MyTable" \
+  --profile production \
+  --region us-west-2 \
+  --keyConditionExpression "pk = :pk" \
+  --expressionAttributeValues '{":pk":{"S":"USER#123"}}'
+```
+

package/skills/tools.md

@@ -1,6 +1,6 @@
 ---
 description: Available MCP tools reference
-related: aws, datadog, debugging
+related: tools-aws, tools-dynamodb, tools-datadog, debugging
 ---
 
 # MCP Tools Reference
@@ -28,16 +28,25 @@ skill("tests")          # Testing patterns
 
 ## AWS Tools
 
+Tools for Lambda, S3, SQS, CloudWatch Logs, Step Functions, and CloudFormation.
+
+See **tools-aws** for complete documentation.
+
 | Tool | Description |
 |------|-------------|
 | `aws_list_profiles` | List AWS profiles from ~/.aws |
-| `aws_lambda_list_functions` | List Lambda functions |
-| `aws_lambda_get_function` | Get Lambda function details |
-| `aws_logs_filter_log_events` | Search CloudWatch Logs |
-| `aws_s3_list_objects` | List S3 bucket objects |
-| `aws_cloudformation_describe_stack` | Get CloudFormation stack details |
+| `aws_lambda_*` | Lambda function management |
+| `aws_logs_*` | CloudWatch Logs search |
+| `aws_s3_*` | S3 bucket operations |
+| `aws_sqs_*` | SQS queue operations |
+| `aws_stepfunctions_*` | Step Functions management |
+| `aws_cloudformation_*` | CloudFormation stack details |
+
+## DynamoDB Tools
+
+Tools for querying, scanning, and inspecting DynamoDB tables.
 
-### DynamoDB
+See **tools-dynamodb** for complete documentation.
 
 | Tool | Description |
 |------|-------------|
@@ -46,23 +55,11 @@ skill("tests")          # Testing patterns
 | `aws_dynamodb_scan` | Full table scan |
 | `aws_dynamodb_get_item` | Get single item |
 
-### SQS
-
-| Tool | Description |
-|------|-------------|
-| `aws_sqs_list_queues` | List SQS queues |
-| `aws_sqs_get_queue_attributes` | Get queue attributes |
-| `aws_sqs_receive_message` | Peek at messages |
-| `aws_sqs_purge_queue` | Delete all messages |
-
-### Step Functions
+## Datadog Tools
 
-| Tool | Description |
-|------|-------------|
-| `aws_stepfunctions_list_executions` | List state machine executions |
-| `aws_stepfunctions_stop_execution` | Stop running execution |
+Tools for logs, monitors, metrics, synthetics, and RUM.
 
-## Datadog Tools
+See **tools-datadog** for complete documentation.
 
 | Tool | Description |
 |------|-------------|
@@ -93,35 +90,3 @@ skill("tests")          # Testing patterns
 - `DD_SERVICE` - Default service filter
 - `DD_SOURCE` - Default log source
 
-## Common Patterns
-
-### Debug Lambda Issues
-
-```
-# Check function config
-aws_lambda_get_function --functionName "my-function"
-
-# Search recent logs
-aws_logs_filter_log_events --logGroupName "/aws/lambda/my-function" --filterPattern "ERROR"
-
-# Or via Datadog
-datadog_logs --query "service:my-function status:error" --from "now-1h"
-```
-
-### Check Queue Health
-
-```
-# Get queue depth
-aws_sqs_get_queue_attributes --queueUrl "https://..."
-
-# Peek at messages
-aws_sqs_receive_message --queueUrl "https://..." --maxNumberOfMessages 5
-```
-
-### Monitor Status
-
-```
-# Check alerting monitors
-datadog_monitors --status '["Alert", "Warn"]'
-```
-

package/skills/vocabulary.md

@@ -0,0 +1,25 @@
+---
+description: Definitions, naming conventions, ontology, and pedantry
+---
+
+# Vocabulary
+
+The "Fabric Vocabulary" attempts to reserve words for implied uses and encourages use of reserved words for conforming uses. It also discourages the use of some words, especially `type`.
+
+## Definitions
+
+## Discouraged Words => Replacements
+
+Reserved for future use
+class, type:  => category, tags
+
+## Fabric Models
+
+### Implied Types
+
+Plural/not
+Reference is an id, alias, xid
+
+## Disclaimer
+
+This is subject to change, especially until @jaypie/dynamodb and @jaypie/fabric hit 1.0. Follow release notes.