mcp-dynamodb mcp

v1.0.0 · MCP Tool · cloud · registry.pascalai.org

Amazon DynamoDB access via REST API. Supports DynamoDB Local (http://localhost:8000, no auth) and AWS DynamoDB (with authHeader). Operations: list_tables, describe_table, get_item, put_item, delete_item, query, scan, update_item, create_table.

dynamodbawsnosqldatabasecloud

Input Parameters

Parameter	Type	Description
operationrequired	string	Operation to perform. One of: `list_tables`, `describe_table`, `get_item`, `put_item`, `delete_item`, `query`, `scan`, `update_item`, `create_table`.
endpointUrlrequired	string	DynamoDB endpoint (e.g. http://localhost:8000 for local or https://dynamodb.us-east-1.amazonaws.com).
tableNameoptional	string	Table name. Required for most operations.
keyoptional	string	JSON object with primary key for get_item/delete_item/update_item (e.g. {"pk":{"S":"user1"}}).
itemoptional	string	JSON DynamoDB item object for put_item.
bodyoptional	string	Raw JSON request body for advanced queries (overrides other params).
keyConditionExpressionoptional	string	Key condition expression for query (e.g. pk = :pk).
expressionAttributeValuesoptional	string	JSON expression attribute values (e.g. {":pk":{"S":"user1"}}).
filterExpressionoptional	string	Filter expression for query/scan.
limitValoptional	integer	Max items to return (default: 100). Default: `100`.
authHeaderoptional	string	Authorization header value for AWS auth (e.g. AWS4-HMAC-SHA256 Credential=...).

Output Fields

Field	Type	Description
tables	array[string]
item	object
items	array[object]
count	integer
ok	boolean
error	string

Examples

Get item from local DynamoDB

// Input
{
  "operation": "get_item",
  "endpointUrl": "http://localhost:8000",
  "tableName": "Users",
  "key": "{\"pk\":{\"S\":\"user1\"}}"
}

// Output
{
  "item": {
    "pk": {
      "S": "user1"
    },
    "name": {
      "S": "Alice"
    }
  }
}

Install & Discovery

Install

ppm install mcp-dynamodb

Get JSON Schema

GET /v1/packages/mcp-dynamodb/1.0.0/schema

Discover by keyword

GET /v1/mcp/discover?q=dynamodb

Discovery hint: Install with ppm install mcp-dynamodb or invoke remotely via POST /v1/invoke/mcp-dynamodb on the MCP Service.

PascalAI Usage

uses toolslib;
var Tool := LoadTool('mcp-dynamodb');
var R := Tool.Call(JsonObj(['operation','list_tables','endpointUrl','http://localhost:8000']));
Writeln(R.ToJSON);