# Jinshuju / 金数据 MCP

> Jinshuju / 金数据 connects your AI client directly to a powerful online form builder, letting you manage data collection workflows via natural conversation. Use it to list forms, get detailed field structures, view all submitted entries, and even programmatically create or update records without ever touching the web interface.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** online-forms, data-collection, webhook-integration, lead-generation, submission-auditing, form-builder

## Description

Jinshuju lets your agent talk to complex data collection systems. Instead of logging into a website with multiple tabs, you just ask your AI client what you need, and it gets it. This MCP connects directly to Jinshuju's backend so your agent can list all existing forms, pull the specific fields they use, or retrieve detailed submissions. If you need to audit leads or check how many people submitted a survey today, you just prompt your agent. You don't navigate menus; your agent does the work for you. Whether it’s tracking customer surveys or automating registration flows, this capability lets your AI client act as a real-time data coordinator. Because Vinkius hosts and manages these MCPs, you connect once from any compatible client and get immediate access to managing structured form data.

## Tools

### create_entry
Submits a new response or record to a specified form.

### delete_entry
Permanently removes a specific submitted entry from the system.

### get_entry
Retrieves all the details for one particular form submission record.

### get_entry_count
Returns the total number of entries collected for a given form.

### get_form
Fetches high-level information and settings about an entire form.

### get_form_fields
Lists every field defined within a form, including data types and requirements.

### list_entries
Retrieves a list of multiple submitted entries for a specified form.

### list_forms
Provides an inventory of every available form managed in the system.

### list_webhooks
Lists all active webhook configurations attached to a form.

### update_entry
Modifies specific data points within an existing, submitted entry.

## Prompt Examples

**Prompt:** 
```
List all my forms in Jinshuju.
```

**Response:** 
```
I've retrieved your Jinshuju forms. You have 12 active forms, including 'Lead Registration V1' and 'Customer Feedback'. Would you like to see the entry count for any of them?
```

**Prompt:** 
```
Show me the last 5 entries for form 'ABC-123'.
```

**Response:** 
```
I've listed the last 5 entries for form ABC-123. They include submissions from 'Mario' and 'Renato'. Should I retrieve the full details for the most recent one?
```

**Prompt:** 
```
Submit a new entry to form 'XYZ-789' with name 'John Doe' and email 'john@example.com'.
```

**Response:** 
```
Done! I've programmatically submitted the new entry to form XYZ-789. The entry has been assigned serial number '8821'.
```

## Capabilities

### Discover Form Structures
Your agent lists all available forms and retrieves specific field definitions for any given form.

### Audit Submissions
The agent views, counts, or retrieves the full details of past form submissions.

### Automate Data Entry
You can programmatically create new entries or modify existing ones using a simple prompt.

### Monitor Data Pipelines
The agent checks and manages configured webhooks to ensure your data flows are healthy.

## Use Cases

### Checking Campaign Performance
The Marketing Ops Manager needs to know how many leads came from their new 'Q3 Survey' and if the webhooks are firing. They ask their agent, which uses `get_entry_count` and `list_webhooks`, getting an immediate count and confirming all pipelines are healthy.

### Correcting Bad Data
A researcher finds that a key piece of data in a submission was entered incorrectly. Instead of manually logging into the system, they ask their agent to use `update_entry` and fix the record instantly.

### Onboarding New Forms
An operations lead needs to know what fields are available for a brand new form. They prompt their agent, which calls `get_form_fields`, giving them the exact data structure they need for integration testing.

### Batch Processing Submissions
A user has multiple records to process and needs to ensure all are captured. They ask their agent to use `list_forms` first, identify the right form ID, and then run `list_entries` for a comprehensive overview.

## Benefits

- Stop manually checking forms. You can now use the `list_forms` tool to get an instant inventory of every single form you run, so you always know where your data is coming from.
- Audit submissions easily. Instead of jumping through pages to check entries, simply ask your agent to view a list of entries using `list_entries`, or pull the full details of one with `get_entry`.
- Keep your data current. If you need to change something in an old record, use the `update_entry` tool. It lets your agent modify existing submissions without manual backend access.
- Understand form structure instantly. The `get_form_fields` tool reads all field definitions for a given form, letting you know exactly what kind of data is accepted before you try to submit anything.
- Build automated pipelines. You can programmatically send or modify entries using the `create_entry` tool, integrating your AI workflows directly with real-world form data.

## How It Works

The bottom line is, once connected, your AI client handles all of the API calls so you don't have to think about them.

1. Subscribe to this MCP on Vinkius, providing your Jinshuju API Key and Secret.
2. Connect your preferred AI client (like Cursor or Claude) using the credentials you just provided.
3. Tell your agent what data you need; it uses the installed tools to query and return the required form information.

## Frequently Asked Questions

**How do I list all my forms using Jinshuju / 金数据 MCP?**
You use the `list_forms` tool. Simply ask your agent to run this tool and it will provide a comprehensive inventory of every form available in your account.

**Can I update old data with Jinshuju / 金数据 MCP?**
Yes, you can modify existing records using the `update_entry` tool. This allows your agent to change specific fields in a submission without deleting or recreating the entry.

**What if I need to know what data types a form accepts?**
Use the `get_form_fields` tool. It reads and reports every defined field, detailing its type (text, number, etc.) so you know exactly how your AI agent can structure input or output.

**Does Jinshuju / 金数据 MCP help with webhooks?**
Yes. You can use the `list_webhooks` tool to view all configured webhook endpoints, helping you audit and monitor your data pipelines for proper functionality.